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

Get-AzureVM

从一个或多个 Azure 虚拟机检索信息。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

Get-AzureVM
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Get-AzureVM
   [-ServiceName] <String>
   [[-Name] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

说明

Get-AzureVM cmdlet 检索有关在 Azure 中运行的虚拟机的信息。 它为当前订阅的指定服务中的所有虚拟机返回一个对象,其中包含有关特定虚拟机的信息,或者如果未指定任何虚拟机。

示例

示例 1:检索指定虚拟机上的信息

PS C:\> Get-AzureVM -ServiceName "ContosoService01" -Name "VirtualMachine02"

此命令返回一个对象,其中包含 ContosoService01 云服务中运行的 VirtualMachine02 虚拟机的相关信息。

示例 2:检索所有虚拟机上的信息

PS C:\> Get-AzureVM -ServiceName "ContosoService01"

此命令检索列表对象,其中包含 ContosoService01 云服务中运行的所有虚拟机的信息。

示例 3:显示虚拟机状态表

PS C:\> Get-AzureVM -ServiceName "ContosoService01"  | Format-Table AutoSize -Property "Name",@{Expression={$_.InstanceUpgradeDomain};Label="UpgDom";Align="Right"},"InstanceStatus"

此命令显示一个表,其中显示了 ContosoService01 服务上运行的虚拟机、其升级域以及每个虚拟机的当前状态。

参数

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
别名:infa
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InformationVariable

指定信息变量。

类型:String
别名:iv
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定要为其检索信息的虚拟机的名称。 如果未提供此参数,则 cmdlet 将返回一个列表对象,其中包含有关指定服务中的所有虚拟机的信息。

类型:String
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServiceName

指定要为其返回虚拟机信息的云服务的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False