Compartilhar via

Get-AzureRmResourceGroup

  • Referência
Módulo:
AzureRM.Resources

Utiliza grupos de recursos.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet Get-AzureRmResourceGroup 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-AzureRmResourceGroup.

Exemplos

Exemplo 1: Obter um grupo de recursos por nome

PS C:\>Get-AzureRmResourceGroup -Name "EngineerBlog"

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

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

PS C:\>(Get-AzureRmResourceGroup -Name "ContosoRG").Tags

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

Exemplo 3: Mostrar os grupos de recursos por local

PS C:\> Get-AzureRmResourceGroup |
  Sort Location,ResourceGroupName |
  Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

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

PS C:\> Get-AzureRmResourceGroup -Location westus2 |
   Sort ResourceGroupName | 
   Format-Wide ResourceGroupName -Column 4

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

PS C:\> Get-AzureRmResourceGroup | Where ResourceGroupName -like WebServer*

Parâmetros

-ApiVersion

Especifica a versão da API compatível com o provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

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

Tipo:String
Aliases:ResourceGroupId, ResourceId
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

Especifica o local do grupo de recursos a ser obtido.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Aliases:ResourceGroupName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Pre

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

A tabela de hash da tag pela qual filtrar grupos de recursos.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Saídas

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup