Condividi tramite


Get-AzResourceGroup

Ottiene i gruppi di risorse.

Sintassi

GetByResourceGroupName (Impostazione predefinita)

Get-AzResourceGroup
    [[-Name] <String>]
    [[-Location] <String>]
    [-Tag <Hashtable>]
    [-ExpandProperties]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByResourceGroupId

Get-AzResourceGroup
    [[-Location] <String>]
    [-Id <String>]
    [-ExpandProperties]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrizione

Il cmdlet Get-AzResourceGroup ottiene i gruppi di risorse di Azure nella sottoscrizione corrente. È possibile ottenere tutti i gruppi di risorse o specificare un gruppo di risorse in base al nome o ad altre proprietà. Per impostazione predefinita, questo cmdlet ottiene tutti i gruppi di risorse nella sottoscrizione corrente. Per altre informazioni sulle risorse di Azure e sui gruppi di risorse di Azure, vedere il cmdlet New-AzResourceGroup.

Esempio

Esempio 1: Ottenere un gruppo di risorse in base al nome

Get-AzResourceGroup -Name "EngineerBlog"

Questo comando ottiene il gruppo di risorse di Azure nella sottoscrizione denominata EngineerBlog.

Esempio 2: Ottenere tutti i tag di un gruppo di risorse

(Get-AzResourceGroup -Name "ContosoRG").Tags

Questo comando ottiene il gruppo di risorse denominato ContosoRG e visualizza i tag associati a tale gruppo.

Esempio 3: Ottenere gruppi di risorse in base al tag

Get-AzResourceGroup -Tag @{'environment'='prod'}

Esempio 4: Visualizzare i gruppi di risorse in base alla posizione

Get-AzResourceGroup |
  Sort-Object Location,ResourceGroupName |
    Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

Esempio 5: Visualizzare i nomi di tutti i gruppi di risorse in una determinata posizione

Get-AzResourceGroup -Location westus2 |
  Sort-Object ResourceGroupName |
    Format-Wide ResourceGroupName -Column 4

Esempio 6: Visualizzare i gruppi di risorse i cui nomi iniziano con WebServer

Get-AzResourceGroup -Name WebServer*

Esempio 7: Ottenere un gruppo di risorse con proprietà espanse

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

Parametri

-ApiVersion

Specifica la versione dell'API supportata dal provider di risorse. È possibile specificare una versione diversa rispetto alla versione predefinita.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExpandProperties

Se specificato, l'output include CreatedTime e ChangedTime di una risorsa.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

Specifica l'ID del gruppo di risorse da ottenere. I caratteri jolly non sono consentiti.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ResourceGroupId, ResourceId

Set di parametri

GetByResourceGroupId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Location

Specifica la posizione del gruppo di risorse da ottenere.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome del gruppo di risorse da ottenere. Questo parametro supporta caratteri jolly all'inizio e/o alla fine della stringa.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False
Alias:ResourceGroupName

Set di parametri

GetByResourceGroupName
Posizione:0
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Pre

Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Tag

Tabella hash per il tag per filtrare i gruppi di risorse.

Proprietà dei parametri

Tipo:Hashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

GetByResourceGroupName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

Hashtable

Output

PSResourceGroup