Saída de consulta de Azure PowerShell

Os resultados de cada cmdlet Azure PowerShell são um objeto Azure PowerShell. Mesmo cmdlets que não são operações explícitas Get- podem retornar um valor que pode ser inspecionado para fornecer informações sobre um recurso que foi criado ou modificado. Enquanto a maioria dos cmdlets retorna um único objeto, alguns retornam uma matriz que deve ser iterada.

Normalmente, consultas a saída de Azure PowerShell com o cmdlet Select-Object. A saída pode ser filtrada com Where-Object.

Selecionar propriedades simples

No formato de tabela padrão, os cmdlets do Azure PowerShell não mostram todas as suas propriedades disponíveis. Você pode obter as propriedades completas usando o cmdlet Format-List ou canalizando a saída para Select-Object -Property *:

Get-AzVM -Name TestVM -ResourceGroupName TestGroup |
  Select-Object -Property *

ResourceGroupName        : TESTGROUP
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/TESTGROUP/providers/Micro
                           soft.Compute/virtualMachines/TestVM
VmId                     : 00000000-0000-0000-0000-000000000000
Name                     : TestVM
Type                     : Microsoft.Compute/virtualMachines
Location                 : westus2
LicenseType              :
Tags                     : {}
AvailabilitySetReference :
DiagnosticsProfile       :
Extensions               : {}
HardwareProfile          : Microsoft.Azure.Management.Compute.Models.HardwareProfile
InstanceView             :
NetworkProfile           : Microsoft.Azure.Management.Compute.Models.NetworkProfile
OSProfile                : Microsoft.Azure.Management.Compute.Models.OSProfile
Plan                     :
ProvisioningState        : Succeeded
StorageProfile           : Microsoft.Azure.Management.Compute.Models.StorageProfile
DisplayHint              : Compact
Identity                 :
Zones                    : {}
FullyQualifiedDomainName :
AdditionalCapabilities   :
RequestId                : 00000000-0000-0000-0000-000000000000
StatusCode               : OK

Depois de saber os nomes das propriedades em que está interessado, pode usá-los com Select-Object para obtê-las diretamente:

Get-AzVM -Name TestVM -ResourceGroupName TestGroup |
  Select-Object -Property Name, VmId, ProvisioningState

Name   VmId                                 ProvisioningState
----   ----                                 -----------------
TestVM 00000000-0000-0000-0000-000000000000 Succeeded

A saída do uso Select-Object é sempre formatada para exibir as informações solicitadas. Para aprender sobre a utilização da formatação como parte da consulta aos resultados do cmdlet, veja Format Azure PowerShell cmdlet output.

Selecionar propriedades aninhadas

Algumas propriedades na saída Azure PowerShell cmdlet usam objetos aninhados, como a propriedade StorageProfile da saída Get-AzVM. Para obter um valor de uma propriedade aninhada, forneça um nome de exibição e o caminho completo para o valor que deseja inspecionar como parte de um argumento de dicionário para Select-Object:

Get-AzVM -ResourceGroupName TestGroup |
  Select-Object -Property Name, @{label='OSType'; expression={$_.StorageProfile.OSDisk.OSType}}

Name     OSType
----     ------
TestVM    Linux
TestVM2   Linux
WinVM   Windows

Cada argumento de dicionário seleciona uma propriedade do objeto. A propriedade a extrair deve fazer parte de uma expressão.

Filtrar resultados

O Where-Object cmdlet permite filtrar o resultado com base em qualquer valor de propriedade, incluindo propriedades subjacentes. O próximo exemplo mostra como usar Where-Object para localizar as VMs do Linux em um grupo de recursos.

Get-AzVM -ResourceGroupName TestGroup |
  Where-Object {$_.StorageProfile.OSDisk.OSType -eq 'Linux'}

ResourceGroupName    Name Location          VmSize OsType        NIC ProvisioningState Zone
-----------------    ---- --------          ------ ------        --- ----------------- ----
TestGroup          TestVM  westus2 Standard_D2s_v3  Linux  testvm299         Succeeded
TestGroup         TestVM2  westus2 Standard_D2s_v3  Linux testvm2669         Succeeded

Você pode canalizar os resultados de Select-Object e Where-Object para o outro. Para fins de desempenho, é sempre recomendado colocar a operação Where-Object antes de Select-Object.

Get-AzVM -ResourceGroupName TestGroup |
  Where-Object {$_.StorageProfile.OsDisk.OsType -eq 'Linux'} |
  Select-Object -Property Name, VmID, ProvisioningState

Name    VmId                                  ProvisioningState
----    ----                                  -----------------
TestVM  00000000-0000-0000-0000-000000000000  Succeeded
TestVM2 00000000-0000-0000-0000-000000000000  Succeeded