Compartilhar via

Get-AzureRmVM

  • Referência
Módulo:
AzureRM.Compute

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

Aviso

O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes 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 do modelo e a exibição da instância de uma máquina virtual do Azure. A exibição do modelo são as propriedades especificadas pelo usuário da máquina virtual. A exibição da instância é o status no nível da instância da máquina virtual. Especifique o parâmetro Status para obter apenas a exibição da 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"

Esse 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

Esse 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 da instância.

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

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

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

Exemplo 4: Obter todas as máquinas virtuais em sua assinatura

PS C:\> Get-AzureRmVM

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

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

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

Esse 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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisplayHint

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

Tipo:DisplayHintType
Valores aceitos:Compact, Expand
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

Especifica um local para as máquinas virtuais listarem.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Aliases:ResourceName, VMName
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NextLink

Especifica o próximo link.

Tipo:Uri
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome de um grupo de recursos.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Status

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

Tipo:SwitchParameter
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Uri

DisplayHintType

Saídas

PSVirtualMachine

PSVirtualMachineInstanceView