Get-AzResourceGroup

  • Referência
Módulo:
Az.Resources

Utiliza grupos de recursos.

Syntax

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

Description

O cmdlet Get-AzResourceGroup obtém grupos de recursos do Azure na assinatura atual. Você pode obter todos os grupos de recursos ou especificar um grupo de recursos por nome ou por outras propriedades. Por padrão, esse cmdlet obtém todos os grupos de recursos na assinatura atual. Para obter mais informações sobre recursos do Azure e grupos de recursos do Azure, consulte o cmdlet New-AzResourceGroup.

Exemplos

Exemplo 1: Obter um grupo de recursos pelo nome

Get-AzResourceGroup -Name "EngineerBlog"

Esse comando obtém o grupo de recursos do Azure em sua assinatura chamado EngineerBlog.

Exemplo 2: Obter todas as tags de um grupo de recursos

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

Esse comando obtém o grupo de recursos chamado ContosoRG e exibe as marcas associadas a esse grupo.

Exemplo 3: Obter grupos de recursos com base na tag

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

Exemplo 4: Mostrar os grupos de recursos por local

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

Exemplo 5: Mostrar os nomes de todos os grupos de recursos em um local específico

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

Exemplo 6: Mostrar os grupos de recursos cujos nomes começam com WebServer

Get-AzResourceGroup -Name WebServer*

Parâmetros

-ApiVersion

Especifica a versão da API que é suportada pelo provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica a ID do grupo de recursos a ser obtido. Caracteres curinga não são permitidos.

Type:String
Aliases:ResourceGroupId, ResourceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Especifica o local do grupo de recursos a ser obtido.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome do grupo de recursos a ser obtido. Esse parâmetro oferece suporte a curingas no início e/ou no final da cadeia de caracteres.

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Pre

Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

A hashtable de tags para filtrar grupos de recursos.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Hashtable

Saídas

PSResourceGroup