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 証明書。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Ip

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LocalUser

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PassThru

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Port

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PrivateKeyFile

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PublicKeyFile

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Rdp

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

リソース グループ名。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ResourceId

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ResourceType

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

型:	String
指定可能な値:	Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SshArgument

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UsePrivateIp

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

String[]

出力

Boolean

関連リンク

• Arzure Arc 対応サーバーへの SSH アクセス
• Azure Arc 対応サーバーへの SSH アクセスのトラブルシューティング
• Microsoft Entra ID を使用して Linux VM にログインする
• Windows 用 OpenSSH をインストールする