Dela via

Get-AzResource

  • Referens
Modul:
Az.Resources

Hämtar resurser.

Syntax

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

Cmdleten Get-AzResource hämtar Azure-resurser.

Exempel

Exempel 1: Hämta alla resurser i den aktuella prenumerationen

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

Det här kommandot hämtar alla resurser i den aktuella prenumerationen.

Exempel 2: Hämta alla resurser i en resursgrupp

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

Det här kommandot hämtar alla resurser i resursgruppen "testRG".

Exempel 3: Hämta alla resurser vars resursgrupp matchar det angivna jokertecknet

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

Det här kommandot hämtar alla resurser vars resursgrupp de tillhör i varelser med "other".

Exempel 4: Hämta alla resurser med ett visst namn

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

Det här kommandot hämtar alla resurser vars resursnamn är "testVM".

Exempel 5: Hämta alla resurser vars namn matchar det angivna jokertecknet

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

Det här kommandot hämtar alla resurser vars resursnamn börjar med "test".

Exempel 6: Hämta alla resurser av en viss resurstyp

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

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

Det här kommandot hämtar alla resurser i de aktuella prenumerationerna som är virtuella datorer.

Exempel 7: Hämta en resurs efter resurs-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

Det här kommandot hämtar resursen med det angivna resurs-ID:t, som är en virtuell dator med namnet "testVM" i resursgruppen "testRG".

Parametrar

-ApiVersion

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpandProperties

Expanderar resursens egenskaper när den har angetts.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Namnet på de resurser som ska hämtas. Den här parametern stöder jokertecken i början och/eller slutet av strängen.

Typ:String
Aliases:ResourceName
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:True

-ODataQuery

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Pre

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Resursgruppen de resurser som hämtas hör till. Den här parametern stöder jokertecken i början och/eller slutet av strängen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:True

-ResourceId

Anger det fullständigt kvalificerade resurs-ID:t, som i följande exempel /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Typ:String
Aliases:Id
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceType

Resurstypen för de resurser som ska hämtas. Till exempel Microsoft.Compute/virtualMachines

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Hämtar resurser som har den angivna Azure-taggen. Ange en hash-tabell med en namnnyckel eller namn och värdenycklar. Jokertecken stöds inte. En "tagg" är ett namn/värde-par som du kan använda för resurser och resursgrupper. Använd taggar för att kategorisera dina resurser, till exempel efter avdelning eller kostnadsställe, eller för att spåra anteckningar eller kommentarer om resurserna. Om du vill lägga till en tagg i en resurs använder du parametern Tagg för cmdletarna New-AzResource eller Set-AzResource. Om du vill skapa en fördefinierad tagg använder du cmdleten New-AzTag. Om du vill ha hjälp med hash-tabeller i Windows PowerShell kör du "Get-Help about_Hashtables".

Typ:Hashtable
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-TagName

Nyckeln i taggen för de resurser som ska hämtas.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-TagValue

Värdet i taggen för de resurser som ska hämtas.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Utdata

PSResource