Partilhar via

Get-AzureRmVM

  • Referência
Módulo:
AzureRM.Compute

Obtém as propriedades de uma máquina virtual.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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>]

Description

O cmdlet Get-AzureRmVM obtém a exibição de modelo e a exibição de instância de uma máquina virtual do Azure. A exibição de modelo é as propriedades especificadas pelo usuário da máquina virtual. A exibição de instância é o status de nível de instância da máquina virtual. Especifique o parâmetro Status para obter apenas a exibição de instância de uma máquina virtual.

Exemplos

Exemplo 1: Obter propriedades de exibição de modelo e instância

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

Este comando obtém as propriedades de exibição de modelo e exibição de instância da máquina virtual chamada VirtualMachine07.

Exemplo 2: Obter propriedades de exibição de instância

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

Este comando obtém propriedades da máquina virtual chamada VirtualMachine07. Este comando especifica o parâmetro Status . Portanto, o comando obtém apenas as propriedades de exibição de instância.

Exemplo 3: Obter propriedades para todas as máquinas virtuais em um grupo de recursos

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

Este comando obtém propriedades para todas as máquinas virtuais no grupo de recursos chamado ResourceGroup11.

Exemplo 4: Obter todas as máquinas virtuais na sua subscrição

PS C:\> Get-AzureRmVM

Este comando obtém todas as máquinas virtuais em sua assinatura.

Exemplo 5: Obtenha todas as máquinas virtuais no local.

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

Este comando obtém todas as máquinas virtuais na região Oeste dos EUA.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayHint

Determina como o objeto de máquina virtual é exibido. Os valores válidos são: -- Compacto: exibe apenas propriedades de nível superior -- Expandir: exibe todas as propriedades em todos os níveis

Tipo:DisplayHintType
Valores aceites:Compact, Expand
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Location

Especifica um local para as máquinas virtuais serem listadas.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome da máquina virtual a ser obtida.

Tipo:String
Aliases:ResourceName, VMName
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NextLink

Especifica o próximo link.

Tipo:Uri
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

Especifica o nome de um grupo de recursos.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Status

Indica que esse cmdlet obtém apenas a exibição de instância da máquina virtual.

Tipo:SwitchParameter
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Uri

DisplayHintType

Saídas

PSVirtualMachine

PSVirtualMachineInstanceView