Get-AzResource
Syntax
ByTagNameValueParameterSet (Standard)
Get-AzResource
[-Name <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
[-TagName <String>]
[-TagValue <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByResourceId
Get-AzResource
-ResourceId <String>
[-ODataQuery <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTagObjectParameterSet
Get-AzResource
-Tag <Hashtable>
[-Name <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beschreibung
Das Cmdlet "Get-AzResource" ruft Azure-Ressourcen ab.
Beispiele
Beispiel 1: Abrufen aller Ressourcen im aktuellen Abonnement
Get-AzResource | Format-Table
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
Dieser Befehl ruft alle Ressourcen im aktuellen Abonnement ab.
Beispiel 2: Abrufen aller Ressourcen in einer Ressourcengruppe
Get-AzResource -ResourceGroupName testRG | Format-Table
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
Dieser Befehl ruft alle Ressourcen in der Ressourcengruppe "testRG" ab.
Beispiel 3: Abrufen aller Ressourcen, deren Ressourcengruppe dem bereitgestellten Wildcard entspricht
Get-AzResource -ResourceGroupName other* | Format-Table
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testKV otherRG Microsoft.KeyVault/vaults eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Dieser Befehl ruft alle Ressourcen ab, deren Ressourcengruppe sie in Wesen mit "anderen" gehören.
Beispiel 4: Abrufen aller Ressourcen mit einem bestimmten Namen
Get-AzResource -Name testVM | Format-List
Name : testVM
ResourceGroupName : testRG
ResourceType : Microsoft.Compute/virtualMachines
Location : westus
ResourceId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tags :
Name Value
====== ========
Dept IT
Year 2002
Status Approved
Dieser Befehl ruft alle Ressourcen ab, deren Ressourcenname "testVM" lautet.
Beispiel 5: Abrufen aller Ressourcen, deren Name dem bereitgestellten Wildcard entspricht
Get-AzResource -Name test* | Format-Table
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
testKV otherRG Microsoft.KeyVault/vaults eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Dieser Befehl ruft alle Ressourcen ab, deren Ressourcenname mit "test" beginnt.
Beispiel 6: Abrufen aller Ressourcen eines bestimmten Ressourcentyps
Get-AzResource -ResourceType Microsoft.Compute/virtualMachines | Format-Table
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Dieser Befehl ruft alle Ressourcen in den aktuellen Abonnements ab, die virtuelle Computer sind.
Beispiel 7: Abrufen einer Ressource nach Ressourcen-ID
Get-AzResource -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
Tags :
Name Value
====== ========
Dept IT
Year 2002
Status Approved
Dieser Befehl ruft die Ressource mit der bereitgestellten Ressourcen-ID ab, bei der es sich um einen virtuellen Computer namens "testVM" in der Ressourcengruppe "testRG" handelt.
Beispiel 8: Abrufen einer Ressource mit erweiterten Eigenschaften
Get-AzResource -Name testVM -ResourceGroupName testRG -ExpandProperties
Dieser Befehl ruft die Ressource "testVM" in der Ressourcengruppe "testRG" ab und erweitert die Eigenschaften, um zusätzliche Details wie CreatedTime, ChangedTime und andere Ressourcenmetadaten einzuschließen.
Parameter
-ApiVersion
Das Cmdlet "Get-AzResource" ruft Azure-Ressourcen ab.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ExpandProperties
Wenn angegeben, werden die Eigenschaften der Ressource erweitert.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Name
Der Name der abzurufenden Ressource(n). Dieser Parameter unterstützt Wildcards am Anfang und/oder Ende der Zeichenfolge.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: True Nicht anzeigen: False Aliase: Ressourcenname
Parametersätze
ByTagNameValueParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
ByTagObjectParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ODataQuery
Das Cmdlet "Get-AzResource" ruft Azure-Ressourcen ab.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Pre
Das Cmdlet "Get-AzResource" ruft Azure-Ressourcen ab.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Die Ressourcengruppe, in der die abgerufene Ressource(n) gehört. Dieser Parameter unterstützt Wildcards am Anfang und/oder Ende der Zeichenfolge.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: True Nicht anzeigen: False
Parametersätze
ByTagNameValueParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
ByTagObjectParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ResourceId
Gibt die vollqualifizierte Ressourcen-ID an, wie im folgenden Beispiel /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: Id
Parametersätze
ByResourceId
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ResourceType
Der Ressourcentyp der abzurufenden Ressource(n). Beispiel: Microsoft.Compute/virtualMachines
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
ByTagNameValueParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
ByTagObjectParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Tag
Ruft Ressourcen ab, die das angegebene Azure-Tag haben. Geben Sie eine Hashtabelle mit einem Namensschlüssel oder einem Namen- und Wertschlüssel ein. Wildcardzeichen werden nicht unterstützt. Ein "Tag" ist ein Namens-Wert-Paar, das Sie auf Ressourcen und Ressourcengruppen anwenden können. Verwenden Sie Kategorien, um Ihre Ressourcen zu kategorisieren, z. B. nach Abteilung oder Kostenstelle, oder um Notizen oder Kommentare zu den Ressourcen nachzuverfolgen. Um einer Ressource ein Tag hinzuzufügen, verwenden Sie den Tag-Parameter der cmdlets New-AzResource oder Set-AzResource. Verwenden Sie das Cmdlet New-AzTag, um ein vordefiniertes Tag zu erstellen. Um Hilfe zu Hashtabellen in Windows PowerShell zu finden, führen Sie "Get-Help about_Hashtables" aus.
Parametereigenschaften
Typ: Hashtable
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
ByTagObjectParameterSet
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-TagName
Der Schlüssel im Tag der abzurufenden Ressource(n).
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
ByTagNameValueParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-TagValue
Der Wert im Tag der abzurufenden Ressource(n).
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
ByTagNameValueParameterSet
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben