Get-AzVM

Referência

Módulo:: Az.Compute

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

Syntax

Get-AzVM
   [[-ResourceGroupName] <String>]
   [[-Name] <String>]
   [-Status]
   [-UserData]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzVM
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Status]
   [-DisplayHint <DisplayHintType>]
   [-UserData]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzVM
   -Location <String>
   [-Status]
   [-UserData]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzVM
   [-Status]
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzVM obtém a exibição de modelo ou 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 a exibição de instância de uma máquina virtual em vez da exibição de modelo, que é o padrão.

Exemplos

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

Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"

ResourceGroupName        : ResourceGroup11
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup11/providers/M
icrosoft.Compute/virtualMachines/VirtualMachine07
VmId                     : 00000000-0000-0000-0000-000000000000
Name                     : VirtualMachine07
Type                     : Microsoft.Compute/virtualMachines
Location                 : eastus
Tags                     : {"creationSource":"acs-VirtualMachine07"}
AvailabilitySetReference : {Id}
DiagnosticsProfile       : {BootDiagnostics}
Extensions               : {linuxdiagnostic, waitforleader}
HardwareProfile          : {VmSize}
NetworkProfile           : {NetworkInterfaces}
OSProfile                : {ComputerName, AdminUsername, LinuxConfiguration, Secrets}
ProvisioningState        : Succeeded
StorageProfile           : {ImageReference, OsDisk, DataDisks}

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

Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Status

ResourceGroupName       : ResourceGroup11
Name                    : VirtualMachine07
Disks[0]                :
  Name                  : VirtualMachine07-osdisk
  Statuses[0]           :
    Code                : ProvisioningState/succeeded
    Level               : Info
    DisplayStatus       : Provisioning succeeded
    Time                : 3/1/2019 12:59:30 AM
Extensions[0]           :
  Name                  : linuxdiagnostic
  Type                  : Microsoft.OSTCExtensions.LinuxDiagnostic
  TypeHandlerVersion    : 2.3.9029
  Statuses[0]           :
    Code                : ProvisioningState/succeeded
    Level               : Info
    DisplayStatus       : Provisioning succeeded
    Message             : Invalid config settings given: Empty storageAccountName. Install will proceed, but enable
can't proceed, in which case it's still considered a success as it's an external error.
Extensions[1]           :
  Name                  : waitforleader
  Type                  : Microsoft.OSTCExtensions.CustomScriptForLinux
  TypeHandlerVersion    : 1.5.4
  Statuses[0]           :
    Code                : ProvisioningState/succeeded
    Level               : Info
    DisplayStatus       : Provisioning succeeded
    Message             : Command is finished.
---stdout---
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
PING leader.mesos (xxx.xx.x.x) 56(84) bytes of data.
64 bytes from xxx.xx.x.x: icmp_seq=1 ttl=64 time=0.022 ms

--- leader.mesos ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 0.022/0.022/0.022/0.000 ms
leader.mesos up

---errout---
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos


PlatformFaultDomain     : 0
PlatformUpdateDomain    : 0
VMAgent                 :
  VmAgentVersion        : 2.2.37
  ExtensionHandlers[0]  :
    Type                : Microsoft.OSTCExtensions.LinuxDiagnostic
    TypeHandlerVersion  : 2.3.9029
    Status              :
      Code              : ProvisioningState/succeeded
      Level             : Info
      DisplayStatus     : Ready
      Message           : Plugin enabled
  ExtensionHandlers[1]  :
    Type                : Microsoft.OSTCExtensions.CustomScriptForLinux
    TypeHandlerVersion  : 1.5.4
    Status              :
      Code              : ProvisioningState/succeeded
      Level             : Info
      DisplayStatus     : Ready
      Message           : Plugin enabled
  Statuses[0]           :
    Code                : ProvisioningState/succeeded
    Level               : Info
    DisplayStatus       : Ready
    Message             : Guest Agent is running
    Time                : 3/1/2019 2:04:12 AM
Statuses[0]             :
  Code                  : ProvisioningState/succeeded
  Level                 : Info
  DisplayStatus         : Provisioning succeeded
  Time                  : 3/1/2019 1:01:57 AM
Statuses[1]             :
  Code                  : PowerState/running
  Level                 : Info
  DisplayStatus         : VM running

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

Get-AzVM -ResourceGroupName "ResourceGroup11"

ResourceGroupName    Name       Location          VmSize  OsType            NIC
-----------------    ----       --------          ------  ------            ---
ResourceGroup11     test1         eastus Standard_DS1_v2 Windows          test1
ResourceGroup11     test2         westus Standard_DS1_v2 Windows          test2
ResourceGroup11     test3         eastus Standard_DS1_v2 Windows          test3

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

Get-AzVM

ResourceGroupName    Name       Location          VmSize  OsType            NIC
-----------------    ----       --------          ------  ------            ---
TEST1               test1         eastus Standard_DS1_v2 Windows          test1
TEST1               test2         westus Standard_DS1_v2 Windows          test2
TEST1               test3         eastus Standard_DS1_v2 Windows          test3
TEST2               test4         westus Standard_DS1_v2 Windows          test4
TEST2               test5         eastus Standard_DS1_v2 Windows          test5

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

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

Get-AzVM -Location "westus"

ResourceGroupName    Name       Location          VmSize  OsType            NIC
-----------------    ----       --------          ------  ------            ---
TEST1               test2         westus Standard_DS1_v2 Windows          test2
TEST2               test4         westus Standard_DS1_v2 Windows          test4

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

Exemplo 6: Obter todas as máquinas virtuais usando filtragem

Get-AzVM -Name test*

ResourceGroupName    Name       Location          VmSize  OsType            NIC
-----------------    ----       --------          ------  ------            ---
TEST1               test1         eastus Standard_DS1_v2 Windows          test1
TEST1               test2         westus Standard_DS1_v2 Windows          test2
TEST1               test3         eastus Standard_DS1_v2 Windows          test3
TEST2               test4         westus Standard_DS1_v2 Windows          test4
TEST2               test5         eastus Standard_DS1_v2 Windows          test5

Este comando faz com que todas as máquinas virtuais com nomes comecem com "test"

Exemplo 7: Obter VM com valor UserData

Get-AzVM -ResourceGroupName <Resource Group Name> -Name <VM Name> -UserData;

ResourceGroupName : <>
Id                : /subscriptions/<Subscription Id>/resourceGroups/<Resource Group Name>/providers/Microsoft
.Compute/virtualMachines/<VM Name>
VmId              : <VM Id>
Name              : <VM Name>
Type              : Microsoft.Compute/virtualMachines
Location          : eastus
Tags              :
{"azsecpack":"nonprod","platformsettings.host_environment.service.platform_optedin_for_rootcerts":"true"}
Extensions        : {Microsoft.Azure.Geneva.GenevaMonitoring,
Microsoft.Azure.Security.AntimalwareSignature.AntimalwareConfiguration}
HardwareProfile   : {VmSize}
NetworkProfile    : {NetworkInterfaces}
OSProfile         : {ComputerName, AdminUsername, WindowsConfiguration, Secrets, AllowExtensionOperations,
RequireGuestProvisionSignal}
ProvisioningState : Succeeded
StorageProfile    : {ImageReference, OsDisk, DataDisks}
UserData          : bm90IGVuY29kZWQ=

O valor UserData deve ser sempre codificado em Base64. Este comando pressupõe que você já tenha criado uma VM com um valor UserData.

Parâmetros

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

-Location

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

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

-Name

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

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

-ResourceGroupName

Especifica o nome de um grupo de recursos.

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

-ResourceId

Id da VM

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

-Status

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

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

-UserData

UserData para a VM, que será codificada em base-64. O cliente não deve passar nenhum segredo aqui.

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

Entradas

String

Uri

DisplayHintType

Saídas

PSVirtualMachine

PSVirtualMachineInstanceView

Get-AzVM

Syntax

Description

Exemplos

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

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

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

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

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

Exemplo 6: Obter todas as máquinas virtuais usando filtragem

Exemplo 7: Obter VM com valor UserData

Parâmetros

-DefaultProfile

-DisplayHint

-Location

-Name

-ResourceGroupName

-ResourceId

-Status

-UserData

Entradas

Saídas

Comentários

Recursos adicionais

Get-AzVM

Syntax

Description

Exemplos

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

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

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

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

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

Exemplo 6: Obter todas as máquinas virtuais usando filtragem

Exemplo 7: Obter VM com valor UserData

Parâmetros

-DefaultProfile

-DisplayHint

-Location

-Name

-ResourceGroupName

-ResourceId

-Status

-UserData

Entradas

Saídas

Ligações Relacionadas

Comentários

Recursos adicionais