Condividi tramite


Get-AzResourceGroup

Ottiene i gruppi di risorse.

Sintassi

Get-AzResourceGroup
   [[-Name] <String>]
   [[-Location] <String>]
   [-Tag <Hashtable>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzResourceGroup
   [[-Location] <String>]
   [-Id <String>]
   [-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*

Parametri

-ApiVersion

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

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

Tipo:String
Alias:ResourceGroupId, ResourceId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Location

Specifica la posizione del gruppo di risorse da ottenere.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

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

Tipo:String
Alias:ResourceGroupName
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-Pre

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tag

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

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

Hashtable

Output

PSResourceGroup