Výstup dotazu Azure PowerShell

Výsledky každé rutiny Azure PowerShell jsou objektem Azure PowerShell. Dokonce i cmdlety, které nejsou explicitně Get- operacemi, mohou vrátit hodnotu, kterou je možné zkontrolovat a která poskytne informace o prostředku, jenž byl vytvořen nebo upraven. Zatímco většina cmdletů vrací jeden objekt, některé z nich vrací pole, které by se mělo iterovat.

Obvykle se dotazujete na výstup z Azure PowerShell pomocí rutiny Select-Object. Výstup lze filtrovat pomocí Where-Object.

Výběr jednoduchých vlastností

Ve výchozím formátu tabulky Azure PowerShell rutiny nezobrazují všechny dostupné vlastnosti. Úplné vlastnosti můžete získat pomocí rutiny Format-List, nebo přesměrováním výstupu do 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

Jakmile znáte názvy vlastností, které vás zajímají, můžete tyto názvy Select-Object vlastností použít k jejich přímému získání:

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

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

Výstup z použití Select-Object je vždy formátován tak, aby zobrazoval požadované informace. Další informace o použití formátování v rámci dotazování výsledků rutin najdete v tématu Format Azure PowerShell výstup rutiny.

Výběr vnořených vlastností

Některé vlastnosti ve výstupu rutiny Azure PowerShell používají vnořené objekty, například vlastnost StorageProfile výstupu Get-AzVM. Pokud chcete získat hodnotu z vnořené vlastnosti, zadejte zobrazovaný název a úplnou cestu k hodnotě, kterou chcete zkontrolovat jako součást argumentu slovníku:Select-Object

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

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

Každý argument slovníku vybere jednu vlastnost z objektu. Vlastnost k extrakci musí být součástí výrazu.

Filtrovat výsledky

Rutina Where-Object umožňuje filtrovat výsledek na základě libovolné hodnoty vlastnosti, včetně vnořených vlastností. Následující příklad ukazuje, jak pomocí Where-Object najít virtuální počítače s Linuxem ve skupině prostředků.

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

Můžete nasměrovat výsledky Select-Object do Where-Object. Pro účely výkonu se vždy doporučuje provést Where-Object operaci před 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