Dela via

Get-AzResource

Modul:
Az.Resources Module

Hämtar resurser.

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

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".

Exempel 8: Hämta en resurs med expanderade egenskaper

Get-AzResource -Name testVM -ResourceGroupName testRG -ExpandProperties

Det här kommandot hämtar resursen med namnet "testVM" i resursgruppen "testRG" och expanderar egenskaperna för att inkludera ytterligare information som CreatedTime, ChangedTime och andra resursmetadata.

Parametrar

-ApiVersion

Cmdleten Get-AzResource hämtar Azure-resurser.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ExpandProperties

Expanderar resursens egenskaper när den har angetts.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False
Alias:Resursnamn

Parameteruppsättningar

ByTagNameValueParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByTagObjectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ODataQuery

Cmdleten Get-AzResource hämtar Azure-resurser.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Pre

Cmdleten Get-AzResource hämtar Azure-resurser.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

ByTagNameValueParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByTagObjectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Id

Parameteruppsättningar

ByResourceId
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceType

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByTagNameValueParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByTagObjectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 Tag 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".

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByTagObjectParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TagName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByTagNameValueParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TagValue

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByTagNameValueParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Utdata

PSResource