Výstup dotazu Azure PowerShellu
Výsledky každé rutiny Azure PowerShellu jsou objektem Azure PowerShellu. Dokonce i rutiny, které nejsou explicitně Get- operace, můžou vrátit hodnotu, kterou je možné zkontrolovat, a poskytnout informace o vytvořeném nebo upraveném prostředku. Zatímco většina cmdletů vrací jeden objekt, některé vrací pole, které by se mělo iterovat.
Obvykle se dotazujete na výstup z Azure PowerShellu pomocí rutiny Select-Object. Výstup lze filtrovat pomocí Where-Object.
Výběr jednoduchých vlastností
Ve výchozím formátu tabulky nezobrazují rutiny Azure PowerShellu všechny dostupné vlastnosti.
Úplné vlastnosti můžete získat pomocí rutiny Format-List nebo pomocí 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 vlastností použít s Select-Object a získat je přímo:
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átovaný tak, aby zobrazoval požadované informace. Další informace o použití formátování v rámci dotazů na výsledky rutin najdete v tématu Formátování výstupu rutin Azure PowerShellu.
Výběr vnořených vlastností
Některé vlastnosti ve výstupu rutiny Azure PowerShell používají vnořené objekty, jako je vlastnost StorageProfile ve 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 pro 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, která se má extrahovat, musí být součástí výrazu.
Filtrování výsledků
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
Výsledky Select-Object a Where-Object můžete vzájemně převést. Pro účely výkonu se vždy doporučuje umístit operaci Where-Object 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
Azure PowerShell