Share via

Get-AzureRmResource

  • Referentie
Module:
AzureRM.Resources

Haalt resources op.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

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

De cmdlet Get-AzureRmResource haalt Azure-resources op.

Voorbeelden

Voorbeeld 1: Alle resources ophalen in het huidige 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

Met deze opdracht worden alle resources in het huidige abonnement opgehaald.

Voorbeeld 2: Alle resources in een resourcegroep ophalen

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

Met deze opdracht worden alle resources in de resourcegroep testRG opgehaald.

Voorbeeld 3: Alle resources ophalen waarvan de resourcegroep overeenkomt met het opgegeven jokerteken

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

Met deze opdracht worden alle resources opgehaald waarvan de resourcegroep ze behoren in wezens met 'ander'.

Voorbeeld 4: Alle resources ophalen met een bepaalde naam

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

Met deze opdracht worden alle resources opgehaald waarvan de resourcenaam 'testVM' is.

Voorbeeld 5: Alle resources ophalen waarvan de naam overeenkomt met het opgegeven jokerteken

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

Met deze opdracht worden alle resources opgehaald waarvan de resourcenaam begint met 'test'.

Voorbeeld 6: Alle resources van een bepaald resourcetype ophalen

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

Met deze opdracht haalt u alle resources op in de huidige abonnementen die virtuele machines zijn.

Voorbeeld 7: Een resource ophalen op resource-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

Met deze opdracht wordt de resource opgehaald met de opgegeven resource-id. Dit is een virtuele machine met de naam 'testVM' in de resourcegroep 'testRG'.

Parameters

-ApiVersion

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

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

-ExpandProperties

Wanneer dit is opgegeven, worden de eigenschappen van de resource uitgebreid.

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

-Name

De naam van de resource(s) die moeten worden opgehaald. Deze parameter ondersteunt jokertekens aan het begin en/of einde van de tekenreeks.

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

-ODataQuery

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

-Pre

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

-ResourceGroupName

De resourcegroep waarin de resource(s) die buiten gebruik is gesteld, behoort tot de resourcegroep. Deze parameter ondersteunt jokertekens aan het begin en/of einde van de tekenreeks.

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

-ResourceId

Hiermee geeft u de volledig gekwalificeerde resource-id op, zoals in het volgende voorbeeld /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

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

-ResourceType

Het resourcetype van de resource(s) die moeten worden opgehaald. Bijvoorbeeld Microsoft.Compute/virtualMachines

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

-Tag

Hiermee haalt u resources op met de opgegeven Azure-tag. Voer een hashtabel in met een naamsleutel of naam- en waardesleutels. Jokertekens worden niet ondersteund. Een tag is een naam-waardepaar dat u kunt toepassen op resources en resourcegroepen. Gebruik tags om uw resources te categoriseren, zoals per afdeling of kostenplaats, of om notities of opmerkingen over de resources bij te houden. Als u een tag wilt toevoegen aan een resource, gebruikt u de tagparameter van de cmdlets New-AzureRmResource of Set-AzureRmResource. Gebruik de cmdlet New-AzureRmTag om een vooraf gedefinieerde tag te maken. Voer 'Get-Help about_Hashtables' uit voor hulp bij hash-tabellen in Windows PowerShell.

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

-TagName

De sleutel in de tag van de resource(s) die moet worden opgehaald.

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

-TagValue

De waarde in de tag van de resource(s) die moet worden opgehaald.

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

Invoerwaarden

None

Uitvoerwaarden

Microsoft.Azure.Commands.ResourceManagement.Models.PSResource