Compartilhar via


Get-AzTag

Obtém marcas predefinidas do Azure | Obtém todo o conjunto de marcas em um recurso ou assinatura.

Sintaxe

Get-AzTag
   [[-Name] <String>]
   [-Detailed]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzTag
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

GetPredefinedTagSet: o cmdlet Get-AzTag obtém marcas predefinidas do Azure em sua assinatura. Esse cmdlet retorna informações básicas sobre as marcas ou informações detalhadas sobre marcas 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 de Marcas do Azure do qual Get-AzTag faz parte pode ajudá-lo a gerenciar marcas predefinidas do Azure. 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 acompanhar anotações ou comentários sobre os recursos e grupos. Você pode definir e aplicar marcas em uma única etapa, mas as marcas predefinidas permitem estabelecer nomes e valores padrão, consistentes e previsíveis para as marcas em sua assinatura. Para criar uma marca predefinida, use o cmdlet New-AzTag. Para aplicar uma marca predefinida a um grupo de recursos, use o parâmetro Tag do cmdlet New-AzTag. Para pesquisar grupos de recursos para um nome de marca específico ou nome e valor, use o parâmetro Tag do cmdlet Get-AzResourceGroup.

GetByResourceIdParameterSet: o cmdlet Get-AzTag com um ResourceId obtém todo o conjunto de marcas em um recurso ou assinatura.

Exemplos

Exemplo 1: Obter todas as marcas predefinidas

Get-AzTag

Name      Count
========  =====

Department    5
FY2015        2
CostCenter   20

Esse comando obtém todas as marcas predefinidas na assinatura. A propriedade Count mostra quantas vezes a marca foi aplicada a recursos e grupos de recursos na assinatura.

Exemplo 2: Obter uma tag por nome

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

        Name        Count
        ==========  =====

        Finance       2
        IT            3

Esse comando obtém informações detalhadas sobre a tag Department e seus valores. A propriedade Count mostra quantas vezes a marca e cada um de seus valores foram aplicados a recursos e grupos de recursos na assinatura.

Exemplo 3: Obter valores de todas as marcas

Get-AzTag -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          5

Esse comando usa o parâmetro Detailed para obter informações detalhadas sobre todas as marcas predefinidas na assinatura. Usar o parâmetro Detailed é o equivalente a usar o parâmetro Name para cada tag.

Exemplo 4: Obter todo o conjunto de marcas em uma assinatura

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

Esse comando obtém todo o conjunto de marcas na assinatura com {subId}.

Exemplo 5: Obter todo o conjunto de marcas em um recurso

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Esse comando obtém todo o conjunto de marcas no recurso com {resourceId}.

Parâmetros

-DefaultProfile

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

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

-Detailed

Indica que essa operação adiciona informações sobre valores de marca à saída.

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

-Name

Nome da tag predefinida. Por padrão, Get-AzTag 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.

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

-ResourceId

O identificador de recurso para a entidade marcada. Um recurso, um grupo de recursos ou uma assinatura pode ser marcado.

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

Entradas

String

SwitchParameter

Saídas

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource