Compartilhar via

Get-AzureRmVM

  • Referência
Módulo:
AzureRM.Compute

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

Aviso

O módulo do PowerShell do AzureRM foi oficialmente preterido em 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 é mais mantido ou suportado, 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 o modo de exibição de modelo e o modo de exibição de instância de uma máquina virtual do Azure. O modo de 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 somente 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"

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"

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

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