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

Get-AzureRmVM

获取虚拟机的属性。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Get-AzureRmVM
   [-Status]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmVM
   [-ResourceGroupName] <String>
   [-Status]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmVM
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Status]
   [-DisplayHint <DisplayHintType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmVM
   -Location <String>
   [-Status]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmVM
   [-Status]
   [-NextLink] <Uri>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzureRmVM cmdlet 获取 Azure 虚拟机的模型视图和实例视图。 模型视图是虚拟机的用户指定属性。 实例视图是虚拟机的实例级别状态。 指定 Status 参数以仅获取虚拟机的实例视图。

示例

示例 1:获取模型和实例视图属性

PS C:\> Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"

此命令获取名为 VirtualMachine07 的虚拟机的模型视图和实例视图属性。

示例 2:获取实例视图属性

PS C:\> Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Status

此命令获取名为 VirtualMachine07 的虚拟机的属性。 此命令指定 Status 参数。 因此,该命令仅获取实例视图属性。

示例 3:获取资源组中所有虚拟机的属性

PS C:\> Get-AzureRmVM -ResourceGroupName "ResourceGroup11"

此命令获取名为 ResourceGroup11 的资源组中的所有虚拟机的属性。

示例 4:获取订阅中的所有虚拟机

PS C:\> Get-AzureRmVM

此命令获取订阅中的所有虚拟机。

示例 5:获取位置中的所有虚拟机。

PS C:\> Get-AzureRmVM -Location "westus"

此命令获取美国西部区域的所有虚拟机。

参数

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-DisplayHint

确定如何显示虚拟机对象。 有效值为:-- Compact:仅显示顶级属性 -- 展开:显示所有级别的所有属性

Type:DisplayHintType
Accepted values:Compact, Expand
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

指定要列出的虚拟机的位置。

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

-Name

指定要获取的虚拟机的名称。

Type:String
Aliases:ResourceName, VMName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

指定下一个链接。

Type:Uri
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定资源组的名称。

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

-Status

指示此 cmdlet 仅获取虚拟机的实例视图。

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

输入

String

Uri

DisplayHintType

输出

PSVirtualMachine

PSVirtualMachineInstanceView