Get-AzureRmResource
Získá prostředky.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntax
Get-AzureRmResource
[[-Name] <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
[-TagName <String>]
[-TagValue <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmResource
-ResourceId <String>
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmResource
[[-Name] <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
-Tag <Hashtable>
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Rutina Get-AzureRmResource získá prostředky Azure.
Příklady
Příklad 1: Získání všech prostředků v aktuálním předplatném
PS C:\> Get-AzureRmResource | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
disk testRG Microsoft.Compute/disks westus
nic testRG Microsoft.Network/networkInterfaces westus
nsg testRG Microsoft.Network/networkSecurityGroups westus
ip testRG Microsoft.Network/publicIPAddresses westus
vnet testRG Microsoft.Network/virtualNetworks westus
testKV otherRG Microsoft.KeyVault/vaults eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Tento příkaz získá všechny prostředky v aktuálním předplatném.
Příklad 2: Získání všech prostředků ve skupině prostředků
PS C:\> Get-AzureRmResource -ResourceGroupName testRG | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
disk testRG Microsoft.Compute/disks westus
nic testRG Microsoft.Network/networkInterfaces westus
nsg testRG Microsoft.Network/networkSecurityGroups westus
ip testRG Microsoft.Network/publicIPAddresses westus
vnet testRG Microsoft.Network/virtualNetworks westus
Tento příkaz získá všechny prostředky ve skupině prostředků testRG.
Příklad 3: Získání všech prostředků, jejichž skupina prostředků odpovídá zadanému zástupu
PS C:\> Get-AzureRmResource -ResourceGroupName other* | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testKV otherRG Microsoft.KeyVault/vaults eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Tento příkaz získá všechny prostředky, jejichž skupina prostředků patří do bytostí s "jinými".
Příklad 4: Získání všech prostředků s daným názvem
PS C:\> Get-AzureRmResource -Name testVM | fl
Name : testVM
ResourceGroupName : testRG
ResourceType : Microsoft.Compute/virtualMachines
Location : westus
ResourceId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tento příkaz získá všechny prostředky, jejichž název prostředku je "testVM".
Příklad 5: Získání všech prostředků, jejichž název odpovídá zadanému zástupné kartě
PS C:\> Get-AzureRmResource -Name test* | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
testKV otherRG Microsoft.KeyVault/vaults eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Tento příkaz získá všechny prostředky, jejichž název prostředku začíná na "test".
Příklad 6: Získání všech prostředků daného typu prostředku
PS C:\> Get-AzureRmResource -ResourceType Microsoft.Compute/virtualMachines | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Tento příkaz získá všechny prostředky v aktuálních předplatných, které jsou virtuální počítače.
Příklad 7: Získání prostředku podle ID prostředku
PS C:\> Get-AzureRmResource -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Name : testVM
ResourceGroupName : testRG
ResourceType : Microsoft.Compute/virtualMachines
Location : westus
ResourceId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tento příkaz získá prostředek se zadaným ID prostředku, což je virtuální počítač s názvem "testVM" ve skupině prostředků "testRG".
Parametry
-ApiVersion
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Typ: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpandProperties
Po zadání rozbalí vlastnosti prostředku.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Název prostředků, které se mají načíst. Tento parametr podporuje zástupné znaky na začátku nebo na konci řetězce.
Typ: | String |
Aliases: | ResourceName |
Position: | 0 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ODataQuery
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Skupina prostředků, do které se prostředky vyřadí, patří. Tento parametr podporuje zástupné znaky na začátku nebo na konci řetězce.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
Určuje plně kvalifikované ID prostředku, jak je znázorněno v následujícím příkladu. /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines
Typ: | String |
Aliases: | Id |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceType
Typ prostředku, který se má načíst. Například Microsoft.Compute/virtualMachines
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Získá prostředky, které mají zadanou značku Azure. Zadejte tabulku hash s klíčem name nebo klíči Name a Value. Zástupné znaky nejsou podporovány. Značka je pár název-hodnota, který můžete použít u prostředků a skupin prostředků. Pomocí značek můžete prostředky kategorizovat, například podle oddělení nebo nákladového střediska, nebo sledovat poznámky nebo komentáře k prostředkům. Pokud chcete přidat značku do prostředku, použijte parametr Tag rutin New-AzureRmResource nebo Set-AzureRmResource. K vytvoření předdefinované značky použijte rutinu New-AzureRmTag. Nápovědu k tabulkám hash ve Windows PowerShellu získáte spuštěním příkazu Get-Help about_Hashtables.
Typ: | Hashtable |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TagName
Klíč ve značce prostředků, které se mají načíst.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TagValue
Hodnota ve značce prostředků, které se mají načíst.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
None
Výstupy
Microsoft.Azure.Commands.ResourceManagement.Models.PSResource