Compartilhar via


New-AzTag

Cria uma marca predefinida do Azure ou adiciona valores a uma marca existente | Cria ou atualiza todo o conjunto de marcas em um recurso ou assinatura.

Sintaxe

New-AzTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzTag
   [-ResourceId] <String>
   [-Tag] <Hashtable>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

CreatePredefinedTagSet: o cmdlet New-AzTag cria uma marca predefinida do Azure com um valor predefinido opcional. Você também pode usá-lo para adicionar valores adicionais a tags predefinidas existentes. Para criar uma tag predefinida, insira um nome de tag exclusivo. Para adicionar um valor a uma marca predefinida existente, especifique o nome da marca existente e o novo valor. Esse cmdlet retorna um objeto que representa a marca nova ou modificada com seus valores e o número de recursos aos quais ela foi aplicada. O módulo de Marcas do Azure do qual New-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 aplicar uma marca predefinida a um recurso ou grupo de recursos, use o parâmetro Tag do cmdlet New-AzTag. Para pesquisar grupos de recursos com um nome de marca especificado ou nome e valor, use o parâmetro Tag do cmdlet Get-AzResourceGroup. Cada tag tem um nome. Os valores são opcionais. Uma marca predefinida do Azure pode ter vários valores, mas quando você aplica a marca a um recurso ou grupo de recursos, aplica o nome da marca e apenas um de seus valores. Por exemplo, você pode criar uma tag de departamento predefinida com um valor para cada departamento, como Finanças, Recursos Humanos e TI. Ao aplicar a marca Department a um recurso, você aplica apenas um valor predefinido, como Finance.

CreateByResourceIdParameterSet: o cmdlet New-AzTag com um ResourceId cria ou atualiza todo o conjunto de marcas em um recurso ou assinatura. Essa operação permite adicionar ou substituir todo o conjunto de marcas no recurso ou assinatura especificado. A entidade especificada pode ter no máximo 50 marcas.

Exemplos

Exemplo 1: Criar uma tag predefinida

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             0     {}

Esse comando cria uma marca predefinida chamada FY2015. Essa tag não tem valores. Você pode aplicar uma marca sem valores a um recurso ou grupo de recursos ou usar New-AzTag para adicionar valores à marca. Você também pode especificar um valor ao aplicar a marca ao recurso ou grupo de recursos.

Exemplo 2: Criar uma tag predefinida com um valor

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 

        Name        Count
        =========   =====
        Finance     0

Esse comando cria uma marca predefinida chamada Departamento com um valor de Finanças.

Exemplo 3: Adicionar um valor a uma tag predefinida

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
New-AzTag -Name "Department" -Value "IT"
Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0
        IT          0

Esses comandos criam uma tag predefinida chamada Department com dois valores. Se o nome da marca existir, New-AzTag adicionará o valor à marca existente em vez de criar uma nova.

Exemplo 4: Usar uma tag predefinida

New-AzTag -Name "CostCenter" -Value "0001"

Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 

Set-AzResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}

Name:      EngineerBlog
Location:  East US
Resources: 
            
  Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US
    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001 

Get-AzTag -Name "CostCenter"

Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 

Get-AzResourceGroup -Tag @{Name="CostCenter"}

Name:      EngineerBlog
Location:  East US
Resources: 
     Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US

    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001

Os comandos neste exemplo criam e usam uma marca predefinida.

Exemplo 5: Cria ou atualiza todo o conjunto de marcas em uma assinatura

$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags

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

Esse comando cria ou atualiza todo o conjunto de marcas na assinatura com {subId}.

Exemplo 6: Cria ou atualiza todo o conjunto de marcas em um recurso

$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags

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

Esse comando cria ou atualiza todo o conjunto de marcas no recurso com {resourceId}.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome da marca predefinida. Para criar uma nova tag predefinida, insira um nome exclusivo. Para adicionar um valor a uma marca existente, insira o nome da marca existente. Se uma marca predefinida existente tiver o nome especificado, New-AzTag adicionará o valor especificado, se houver, à marca com esse nome em vez de criar uma nova marca.

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

-ResourceId

O identificador de recurso da entidade que está sendo marcada. Um recurso, um grupo de recursos ou uma assinatura pode ser marcado.

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

-Tag

As tags a serem colocadas no recurso.

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

-Value

Especifica um valor de tag predefinido. As tags predefinidas podem ter vários valores, mas você pode inserir apenas um valor em cada comando. Esse parâmetro é opcional, pois as tags podem ter nomes sem valores.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

String

Hashtable

Saídas

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