你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

连接到 Azure Stack Edge Pro GPU 设备上的虚拟机控制台

适用于：Azure Stack Edge Pro - GPUAzure Stack Edge Pro 2Azure Stack Edge Pro RAzure Stack Edge Mini R

Azure Stack Edge Pro GPU 解决方案通过虚拟机运行非容器化工作负载。 本文介绍如何连接到设备上部署的虚拟机的控制台。

利用虚拟机控制台，可以使用常用远程桌面工具通过键盘、鼠标和屏幕功能来访问 VM。 可以访问控制台并排查在设备上部署虚拟机时遇到的任何问题。 即使 VM 预配失败，你也可以连接到虚拟机控制台。

工作流

大致工作流包括以下步骤：

1. 连接到设备上的 PowerShell 接口。
2. 启用对 VM 的控制台访问。
3. 使用远程桌面协议 (RDP)连接到 VM。
4. 撤销对 VM 的控制台访问。

先决条件

在开始之前，请确保已经具备了以下先决条件：

对于你的设备

应该有权访问已激活的 Azure Stack Edge Pro GPU 设备。 设备上必须已经部署了一个或多个 VM。 可以通过 Azure PowerShell、通过模板，或通过 Azure 门户来部署 VM。

对于访问设备的客户端

确保你有权访问符合以下条件的客户端系统：

• 可以访问设备的 PowerShell 界面。 该客户端运行受支持的操作系统。
• 该客户端运行 PowerShell 7.0 或更高版本。 此版本的 PowerShell 适用于 Windows、Mac 和 Linux 客户端。 请参阅说明来安装 PowerShell 7。
• 具有远程桌面功能。 根据你使用的是 Windows、macOS 还是 Linux，应该安装这些远程桌面客户端之一。 本文提供了有关 Windows 远程桌面和 FreeRDP 的说明。

连接到 VM 控制台

请按照以下步骤连接到设备上的虚拟机控制台。

连接到设备上的 PowerShell 接口

第一步是连接到设备的 PowerShell 界面。

启用对 VM 的控制台访问

1. 在 PowerShell 界面中，运行以下命令来启用对 VM 控制台的访问。

   Grant-HcsVMConnectAccess -ResourceGroupName <VM resource group> -VirtualMachineName <VM name>
   

2. 在示例输出中，记下虚拟机 ID。 在后面的步骤中会需要用到此信息。

   [10.100.10.10]: PS>Grant-HcsVMConnectAccess -ResourceGroupName mywindowsvm1rg -VirtualMachineName mywindowsvm1
   
   VirtualMachineId       : 81462e0a-decb-4cd4-96e9-057094040063
   VirtualMachineHostName : 3V78B03
   ResourceGroupName      : mywindowsvm1rg
   VirtualMachineName     : mywindowsvm1
   Id                     : 81462e0a-decb-4cd4-96e9-057094040063
   [10.100.10.10]: PS>
   

连接到 VM

现在可以使用远程桌面客户端连接到虚拟机控制台了。

使用 Windows 远程桌面

1. 创建新文本文件并输入以下文本。

   pcb:s:<VM ID from PowerShell>;EnhancedMode=0
   full address:s:<IP address of the device>
   server port:i:2179
   username:s:EdgeARMUser
   negotiate security layer:i:0
   

2. 将该文件在客户端系统上另存为 *.rdp。 你将使用此配置文件来连接到 VM。

3. 双击该配置文件来连接到 VM。 提供以下凭据：

   • 用户名：以 EdgeARMUser 身份登录。
   • 密码：提供设备的本地 Azure 资源管理器密码。 如果忘记了密码，请通过 Azure 门户重置 Azure 资源管理器密码。

使用 FreeRDP

如果在 Linux 客户端上使用 FreeRDP，请运行以下命令：

./wfreerdp /u:EdgeARMUser /vmconnect:<VM ID from PowerShell> /v:<IP address of the device>

撤销 VM 控制台访问权限

若要撤销对 VM 控制台的访问权限，请返回到设备的 PowerShell 界面。 运行以下命令：

Revoke-HcsVMConnectAccess -ResourceGroupName <VM resource group> -VirtualMachineName <VM name>

下面是示例输出：

[10.100.10.10]: PS>Revoke-HcsVMConnectAccess -ResourceGroupName mywindowsvm1rg -VirtualMachineName mywindowsvm1

VirtualMachineId       : 81462e0a-decb-4cd4-96e9-057094040063
VirtualMachineHostName : 3V78B03
ResourceGroupName      : mywindowsvm1rg
VirtualMachineName     : mywindowsvm1
Id                     : 81462e0a-decb-4cd4-96e9-057094040063

[10.100.10.10]: PS>

注意

在使用 VM 控制台完成操作后，建议撤销访问权限，或关闭 PowerShell 窗口以退出该会话。

后续步骤

• 在 Azure 门户中排查 VM 部署问题。