Get-AzureRmTag
Obtém marcas do Azure predefinidas.
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-AzureRmTag
[[-Name] <String>]
[-Detailed]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
O cmdlet Get-AzureRmTag obtém marcas do Azure predefinidas em sua assinatura. Este cmdlet retorna informações básicas sobre as tags ou informações detalhadas sobre tags e seus valores. Todos os objetos de saída incluem uma propriedade Count que representa o número de recursos e grupos de recursos aos quais as marcas e os valores foram aplicados. O módulo Marcas do Azure do qual Get-AzureRMTag faz parte pode ajudá-lo a gerenciar marcas do Azure predefinidas. Uma marca do Azure é um par nome-valor que você pode usar para categorizar seus recursos e grupos de recursos do Azure, como por departamento ou centro de custo, ou para controlar anotações ou comentários sobre os recursos e grupos. Você pode definir e aplicar tags em uma única etapa, mas as tags predefinidas permitem estabelecer nomes e valores padrão, consistentes e previsíveis para as tags em sua assinatura. Para criar uma marca predefinida, use o cmdlet New-AzureRmTag. Para aplicar uma marca predefinida a um grupo de recursos, use o parâmetro Tag do cmdlet New-AzureRmTag. Para pesquisar grupos de recursos por um nome de marca específico ou nome e valor, use o parâmetro Tag do cmdlet Get-AzureRMResourceGroup.
Exemplos
Exemplo 1: Obter todas as tags predefinidas
PS C:\>Get-AzureRmTag
Name Count
======== =====
Department 5
FY2015 2
CostCenter 20Este comando obtém todas as tags predefinidas na assinatura. A propriedade Count mostra quantas vezes a tag foi aplicada a recursos e grupos de recursos na assinatura.
Exemplo 2: Obter uma etiqueta por nome
PS C:\>Get-AzureRmTag -Name "Department"
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3Este comando obtém informações detalhadas sobre a tag Department e seus valores. A propriedade Count mostra quantas vezes a tag e cada um de seus valores foram aplicados a recursos e grupos de recursos na assinatura.
Exemplo 3: Obter valores de todas as tags
PS C:\>Get-AzureRmTag -Detailed
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3
Name: FY2015
Count: 2
Name: CostCenter
Count: 20
Values:
Name Count
========== =====
0001 5
0002 10
0003 5Este comando usa o parâmetro Detailed para obter informações detalhadas sobre todas as tags predefinidas na assinatura. Usar o parâmetro Detailed é o equivalente a usar o parâmetro Name para cada tag.
Parâmetros
-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 |
-Detailed
Indica que essa operação adiciona informações sobre valores de tag à saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica o nome da tag a ser obtida. Por padrão, Get-AzureRmTag obtém informações básicas sobre todas as marcas predefinidas na assinatura. Quando você especifica o parâmetro Name , o parâmetro Detailed não tem efeito.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |