Get-AzResourceGroup
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 |