Enter-AzVM

リファレンス

モジュール:: Az.Ssh

Azure リソース (Azure VM や Arc Server など) への対話型 SSH セッションを開始します。ユーザーは、Microsoft Entra アカウント、または標準の SSH 認証を使用してローカルユーザーアカウントを使用してログインできます。セキュリティと利便性を最大限に高めるには、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>]

説明

Azure リソースへの対話型 SSH セッションを開始します (現在、Azure VM と Arc Server がサポートされています)。ユーザーは、Microsoft Entra で発行された証明書を使用するか、ローカルユーザーの資格情報を使用してログインできます。可能な場合は、Microsoft Entra が発行した証明書を使用してログインすることをお勧めします。重要な注意: Azure Arc リソースに接続する場合、このコマンドレットでは、Az.Ssh.ArcProxy モジュールもクライアントコンピューターにインストールする必要があります。コマンドレットはPowerShell ギャラリーからモジュールのインストールを試みますが、ユーザーはモジュールを自分でインストールすることもできます。ユーザーが Az.Ssh.ArcProxy モジュールでプロキシファイルを実行するアクセス許可を持っているか、接続が失敗することが重要です。 Az.Ssh.ArcServer モジュールは、PowerShell ギャラリーにありますhttps://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy。

例

例 1: Microsoft Entra で発行された証明書を使用して Azure リソースに接続する

Enter-AzVM -ResourceGroupName myRg -Name myMachine

-LocalUser が指定されていない場合、コマンドレットは Microsoft Entra ID を使用してログインを試みます。これは現在、Linux OS を実行しているリソースでのみサポートされています。

例 2: 認証に SSH 証明書を使用して Azure Resource 上のローカルユーザーに接続する

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

例 3: 認証に SSH 秘密キーを使用して Azure Resource 上のローカルユーザーに接続する

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

例 4: 対話型のユーザー名とパスワード認証を使用して Azure Resource のローカルユーザーに接続する

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 Resource に接続する

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

カスタムキーファイルが指定されていない場合、コマンドレットによってキーペアが生成されます。

例 8: SSH 接続経由で RDP 接続を開始します。

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

このパラメーターは、Arc Connectivity Platform 経由で Arc リソースへの RDP セッションを作成する場合に役立ちます。

パラメーター

-CertificateFile

ローカルユーザーアカウントに対する認証に使用される SSH 証明書。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Arc リソースに接続する場合は、接続エンドポイントで SSH 接続の許可ポートを更新してターゲットポートに一致させるか、必要に応じて、PowerShell ギャラリーから Az.Ssh.ArcProxy モジュールをインストールする前に確認を求めないでください。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Ip

ターゲット Azure VM の IP アドレス。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LocalUser

ターゲットリソース内のローカルユーザーのユーザー名。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

ターゲットの Azure リソースの名前。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

接続が成功した場合は true を返します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

リモートホスト上で接続するポート。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrivateKeyFile

秘密キーファイルへのパス。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicKeyFile

公開キーファイルへのパス。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Rdp

SSH 接続経由で RDP 接続を開始します。 Windows OS でのみサポートされます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

リソースグループ名。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceId

ターゲットリソースのリソース ID。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceType

ターゲットリソースのリソースの種類。

Type:	String
Accepted values:	Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SshArgument

OpenSSH に渡される追加の SSH 引数。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UsePrivateIp

Azure VM に接続する場合、このフラグは、VM のいずれかのプライベート IP に接続する必要があることを指定します。プライベート IP への接続が必要です。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

String

String[]

出力

Boolean

次の方法で共有

Enter-AzVM

構文

説明

例

例 1: Microsoft Entra で発行された証明書を使用して Azure リソースに接続する

例 2: 認証に SSH 証明書を使用して Azure Resource 上のローカルユーザーに接続する

例 3: 認証に SSH 秘密キーを使用して Azure Resource 上のローカルユーザーに接続する

例 4: 対話型のユーザー名とパスワード認証を使用して Azure Resource のローカルユーザーに接続する

例 5: Microsoft Entra で発行された証明書を使用して Azure 仮想マシンのパブリック IP に接続する

例 6: ターゲットのリソースの種類を指定します。

例 7: Microsoft Entra 証明書によって発行された証明書とカスタムキーファイルを使用して Azure Resource に接続する

例 8: SSH 接続経由で RDP 接続を開始します。

パラメーター

-CertificateFile

-DefaultProfile

-Force

-Ip

-LocalUser

-Name

-PassThru

-Port

-PrivateKeyFile

-PublicKeyFile

-Rdp

-ResourceGroupName

-ResourceId

-ResourceType

-SshArgument

-UsePrivateIp

入力

出力

その他のリソース

次の方法で共有

Enter-AzVM

構文

説明

例

例 1: Microsoft Entra で発行された証明書を使用して Azure リソースに接続する

例 2: 認証に SSH 証明書を使用して Azure Resource 上のローカル ユーザーに接続する

例 3: 認証に SSH 秘密キーを使用して Azure Resource 上のローカル ユーザーに接続する

例 4: 対話型のユーザー名とパスワード認証を使用して Azure Resource のローカル ユーザーに接続する

例 5: Microsoft Entra で発行された証明書を使用して Azure 仮想マシンのパブリック IP に接続する

例 6: ターゲットのリソースの種類を指定します。

例 7: Microsoft Entra 証明書によって発行された証明書とカスタム キー ファイルを使用して Azure Resource に接続する

例 8: SSH 接続経由で RDP 接続を開始します。

パラメーター

-CertificateFile

-DefaultProfile

-Force

-Ip

-LocalUser

-Name

-PassThru

-Port

-PrivateKeyFile

-PublicKeyFile

-Rdp

-ResourceGroupName

-ResourceId

-ResourceType

-SshArgument

-UsePrivateIp

入力

出力

関連リンク

その他のリソース

例 2: 認証に SSH 証明書を使用して Azure Resource 上のローカルユーザーに接続する

例 3: 認証に SSH 秘密キーを使用して Azure Resource 上のローカルユーザーに接続する

例 4: 対話型のユーザー名とパスワード認証を使用して Azure Resource のローカルユーザーに接続する

例 7: Microsoft Entra 証明書によって発行された証明書とカスタムキーファイルを使用して Azure Resource に接続する