Get-AzureRmResource

Referenz

Modul:: AzureRM.Resources

Dient zum Abrufen von Ressourcen.

Wichtig

Die Az PowerShell-Module bieten nun die gleichen Funktionen wie AzureRM PowerShell-Module und weitere Funktionen, daher werden die AzureRM PowerShell-Module am 29 Februar 2024 ausgemustert.

Um Dienstunterbrechungen zu vermeiden, müssen Sie bis zum 29. Februar 2024 die Skripts aktualisieren, die AzureRM PowerShell-Module verwenden. Befolgen Sie zum automatischen Aktualisieren Ihrer Skripts die Schnellstartanleitung.

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>]

Beschreibung

Das Cmdlet Get-AzureRmResource ruft Azure-Ressourcen ab.

Beispiele

Beispiel 1: Abrufen aller Ressourcen im aktuellen Abonnement

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

Dieser Befehl ruft alle Ressourcen im aktuellen Abonnement ab.

Beispiel 2: Abrufen aller Ressourcen in einer Ressourcengruppe

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

Dieser Befehl ruft alle Ressourcen in der Ressourcengruppe "testRG" ab.

Beispiel 3: Abrufen aller Ressourcen, deren Ressourcengruppe dem bereitgestellten Wildcard entspricht

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

Dieser Befehl ruft alle Ressourcen ab, deren Ressourcengruppe sie in Wesen mit "anderen" gehören.

Beispiel 4: Abrufen aller Ressourcen mit einem angegebenen Namen

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

Dieser Befehl ruft alle Ressourcen ab, deren Ressourcenname "testVM" ist.

Beispiel 5: Abrufen aller Ressourcen, deren Name dem bereitgestellten Wildcard entspricht

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

Dieser Befehl ruft alle Ressourcen ab, deren Ressourcenname mit "test" beginnt.

Beispiel 6: Abrufen aller Ressourcen eines bestimmten Ressourcentyps

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

Dieser Befehl ruft alle Ressourcen in den aktuellen Abonnements ab, die virtuelle Computer sind.

Beispiel 7: Abrufen einer Ressource nach Ressourcen-ID

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

Dieser Befehl ruft die Ressource mit der bereitgestellten Ressourcen-ID ab, die ein virtueller Computer namens "testVM" in der Ressourcengruppe "testRG" ist.

Parameter

-ApiVersion

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnement, die für die Kommunikation mit Azure verwendet werden

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpandProperties

Wenn angegeben, erweitern Sie die Eigenschaften der Ressource.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Der Name der zu abrufenden Ressource(n) Dieser Parameter unterstützt Wildcards am Anfang und/oder Ende der Zeichenfolge.

Type:	String
Aliases:	ResourceName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ODataQuery

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Pre

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Die Ressourcengruppe, in der die Ressource(n) eingestellt ist, gehört dazu. Dieser Parameter unterstützt Wildcards am Anfang und/oder Ende der Zeichenfolge.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Gibt die vollqualifizierte Ressourcen-ID an, wie im folgenden Beispiel /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceType

Der Ressourcentyp der ressource(n), die abgerufen werden soll. Beispiel: Microsoft.Compute/virtualMachines

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Ruft Ressourcen ab, die über das angegebene Azure-Tag verfügen. Geben Sie eine Hashtabelle mit einem Namenschlüssel oder einem Wertschlüssel ein. Wildcardzeichen werden nicht unterstützt. Ein "Tag" ist ein Name-Wert-Paar, das Sie auf Ressourcen und Ressourcengruppen anwenden können. Verwenden Sie Tags zum Kategorisieren Ihrer Ressourcen, z. B. nach Abteilung oder Kostencenter, oder zum Nachverfolgen von Notizen oder Kommentaren zu den Ressourcen. Verwenden Sie zum Hinzufügen eines Tags zu einer Ressource den Tag-Parameter des New-AzureRmResource oder Set-AzureRmResource Cmdlets. Verwenden Sie zum Erstellen eines vordefinierten Tags das Cmdlet New-AzureRmTag. Führen Sie "Get-Help about_Hashtables" aus, um Hilfe bei Hashtabellen in Windows PowerShell zu erhalten.

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TagName

Der Schlüssel im Tag der Ressource(n), die abgerufen werden soll.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TagValue

Der Wert im Tag der ressource(n), die abgerufen werden soll.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

None

Ausgaben

Microsoft.Azure.Commands.ResourceManagement.Models.PSResource