Enter-AzVM

參考

模組:: Az.Ssh

啟動 Azure 資源的互動式 SSH 工作階段（例如 Azure VM 或 Arc Server）。用戶可以透過標準 SSH 驗證，使用 Microsoft Entra 帳戶或本機用戶帳戶登入。使用 Microsoft Entra 帳戶登入，以獲得最佳安全性和便利性。

語法

Enter-AzVM
     -ResourceGroupName <String>
     -Name <String>
     [-PublicKeyFile <String>]
     [-PrivateKeyFile <String>]
     [-UsePrivateIp]
     [-LocalUser <String>]
     [-Port <String>]
     [-ResourceType <String>]
     [-CertificateFile <String>]
     [-SshArgument <String[]>]
     [-Rdp]
     [-PassThru]
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Enter-AzVM
     -Ip <String>
     [-PublicKeyFile <String>]
     [-PrivateKeyFile <String>]
     [-LocalUser <String>]
     [-Port <String>]
     [-CertificateFile <String>]
     [-SshArgument <String[]>]
     [-Rdp]
     [-PassThru]
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Enter-AzVM
     -ResourceId <String>
     [-PublicKeyFile <String>]
     [-PrivateKeyFile <String>]
     [-UsePrivateIp]
     [-LocalUser <String>]
     [-Port <String>]
     [-CertificateFile <String>]
     [-SshArgument <String[]>]
     [-Rdp]
     [-PassThru]
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Description

啟動 Azure 資源的互動式 SSH 工作階段（目前支援 Azure VM 和 Arc Server）。使用者可以使用 Microsoft Entra 發行的憑證或使用本機使用者認證登入。建議您盡可能使用 Microsoft Entra 發行的憑證登入。重要注意事項：連線到 Azure Arc 資源時，此 Cmdlet 需要同時在用戶端計算機中安裝 Az.Ssh.ArcProxy 模組。 Cmdlet 會嘗試從 PowerShell 資源庫安裝模組，但使用者也可以選擇自行安裝模組。用戶也必須有權在 Az.Ssh.ArcProxy 模組中執行 Proxy 檔案，否則連線將會失敗。您可以在 PowerShell 資源庫中找到 Az.Ssh.ArcServer 模組：https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy。

範例

範例 1：使用 Microsoft Entra 簽發的憑證聯機到 Azure 資源

Enter-AzVM -ResourceGroupName myRg -Name myMachine

未提供 -LocalUser 時，Cmdlet 會嘗試使用 Microsoft Entra ID 登入。目前僅支持執行 Linux OS 的資源。

範例 2：使用 SSH 憑證進行驗證，連線到 Azure 資源上的本機使用者

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa -CertificateFile ./cert

範例 3：使用 SSH 私鑰連線到 Azure 資源上的本機使用者以進行驗證

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa

範例 4：使用互動式使用者名稱和密碼驗證連線到 Azure 資源上的本機使用者

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser

範例 5：使用 Microsoft Entra 簽發的憑證聯機到 Azure 虛擬機的公用 IP

Enter-AzVM -Ip 1.2.3.4

範例 6：提供目標的資源類型。

Enter-AzVM -ResourceGroupName myRg -Name myMachine -ResourceType Microsoft.HybridCompute/machines

當資源群組中有多個支持的資源具有相同名稱時，此參數就很有用。

範例 7：使用 Microsoft Entra 憑證發行的憑證和自定義密鑰檔案連線至 Azure 資源

Enter-AzVM -ResourceGroupName myRg -Name myMachine -PrivateKeyFile ./id_rsa -PublicKeyFile ./id_rsa.pub

如果未提供自定義金鑰檔案，Cmdlet 將會產生金鑰組。

範例 8：透過 SSH 連線啟動 RDP 連線。

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser username -Rdp

此參數適用於透過Arc連線平臺建立Arc資源的 RDP 工作階段。

參數

-CertificateFile

用來向本機用戶帳戶進行驗證的 SSH 憑證。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

聯機到 Arc 資源時，在更新連線端點中允許的 SSH 連線埠以符合目標埠，或視需要從 PowerShell 資源庫安裝 Az.Ssh.ArcProxy 模組之前，請勿提示確認。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Ip

目標 Azure VM 的 IP 位址。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-LocalUser

目標資源中本機用戶的用戶名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

目標 Azure 資源的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-PassThru

如果連接成功，則傳回 true。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Port

要連線到遠端主機上的埠。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrivateKeyFile

私鑰檔案的路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublicKeyFile

公鑰檔案的路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Rdp

透過 SSH 連線啟動 RDP 連線。僅支援 Windows OS。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源組名。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ResourceId

目標資源的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ResourceType

目標資源的資源類型。

類型:	String
接受的值:	Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SshArgument

傳遞至 OpenSSH 的其他 SSH 自變數。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UsePrivateIp

連線到 Azure VM 時，此旗標會指定它應該連線到 VM 的其中一個私人 IP。它需要連線到私人IP。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

String[]

輸出

Boolean

共用方式為

Enter-AzVM

語法

Description

範例

範例 1：使用 Microsoft Entra 簽發的憑證聯機到 Azure 資源

範例 2：使用 SSH 憑證進行驗證，連線到 Azure 資源上的本機使用者

範例 3：使用 SSH 私鑰連線到 Azure 資源上的本機使用者以進行驗證

範例 4：使用互動式使用者名稱和密碼驗證連線到 Azure 資源上的本機使用者

範例 5：使用 Microsoft Entra 簽發的憑證聯機到 Azure 虛擬機的公用 IP

範例 6：提供目標的資源類型。

範例 7：使用 Microsoft Entra 憑證發行的憑證和自定義密鑰檔案連線至 Azure 資源

範例 8：透過 SSH 連線啟動 RDP 連線。

參數

-CertificateFile

-DefaultProfile

-Force

-Ip

-LocalUser

-Name

-PassThru

-Port

-PrivateKeyFile

-PublicKeyFile

-Rdp

-ResourceGroupName

-ResourceId

-ResourceType

-SshArgument

-UsePrivateIp

輸入

輸出

其他資源

共用方式為

Enter-AzVM

語法

Description

範例

範例 1：使用 Microsoft Entra 簽發的憑證聯機到 Azure 資源

範例 2：使用 SSH 憑證進行驗證，連線到 Azure 資源上的本機使用者

範例 3：使用 SSH 私鑰連線到 Azure 資源上的本機使用者以進行驗證

範例 4：使用互動式使用者名稱和密碼驗證連線到 Azure 資源上的本機使用者

範例 5：使用 Microsoft Entra 簽發的憑證聯機到 Azure 虛擬機的公用 IP

範例 6：提供目標的資源類型。

範例 7：使用 Microsoft Entra 憑證發行的憑證和自定義密鑰檔案連線至 Azure 資源

範例 8：透過 SSH 連線啟動 RDP 連線。

參數

-CertificateFile

-DefaultProfile

-Force

-Ip

-LocalUser

-Name

-PassThru

-Port

-PrivateKeyFile

-PublicKeyFile

-Rdp

-ResourceGroupName

-ResourceId

-ResourceType

-SshArgument

-UsePrivateIp

輸入

輸出

相關連結

其他資源