Get-AzureRmResourceGroup
Obtém grupos de recursos.
Aviso
O módulo AzureRM PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Syntax
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"
Este 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
PS C:\>(Get-AzureRmResourceGroup -Name "ContosoRG").Tags
Este 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 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: | 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: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica o nome do grupo de recursos a ser obtido. Este parâmetro suporta curingas no início e/ou no final da cadeia de caracteres.
Type: | String |
Aliases: | ResourceGroupName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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
None
Saídas
Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup