Delen via


Get-AzResource

Haalt resources op.

Syntaxis

Get-AzResource
   [-Name <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   [-TagName <String>]
   [-TagValue <String>]
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzResource
   -ResourceId <String>
   [-ODataQuery <String>]
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzResource
   [-Name <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   -Tag <Hashtable>
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

De Get-AzResource-cmdlet haalt Azure-resources op.

Voorbeelden

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

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

Voorbeeld 2: Alle resources in een resourcegroep ophalen

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

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

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

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

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

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

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

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

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

Voorbeeld 6: Alle resources van een bepaald resourcetype ophalen

Get-AzResource -ResourceType Microsoft.Compute/virtualMachines | Format-Table

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

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

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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExpandProperties

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Aliassen:ResourceName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-ODataQuery

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Pre

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De resourcegroep waarin de resource(s) zijn opgehaald, behoort tot de resourcegroep. Deze parameter ondersteunt jokertekens aan het begin en/of einde van de tekenreeks.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-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
Aliassen:Id
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceType

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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-AzResource of Set-AzResource. Gebruik de cmdlet New-AzTag 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
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TagName

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TagValue

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

PSResource