Get-AzResourceGroup
Obtém 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 por nome
Get-AzResourceGroup -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
(Get-AzResourceGroup -Name "ContosoRG").Tags
Este 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 suportada pelo provedor de recursos. Você pode especificar uma versão diferente da versão padrão.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | 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
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predefinido: | None |
Necessário: | 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.
Tipo: | String |
Aliases: | ResourceGroupId, ResourceId |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Especifica o local do grupo de recursos a ser obtido.
Tipo: | String |
Position: | 1 |
valor predefinido: | None |
Necessário: | 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.
Tipo: | String |
Aliases: | ResourceGroupName |
Position: | 0 |
valor predefinido: | None |
Necessário: | 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.
Tipo: | SwitchParameter |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
A hashtable de tags para filtrar grupos de recursos.
Tipo: | Hashtable |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
Saídas
Ligações Relacionadas
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários