Partilhar via

New-AzTag

  • Referência
Módulo:
Az.Resources

Cria uma marca predefinida do Azure ou adiciona valores a uma marca existente | Cria ou atualiza todo o conjunto de tags 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 do Azure predefinida 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 tag predefinida existente, especifique o nome da tag existente e o novo valor. Este 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 Marcas do Azure do qual New-AzTag 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 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 Department predefinida com um valor para cada departamento, como Finanças, Recursos Humanos e TI. Ao aplicar a tag Department a um recurso, você aplica apenas um valor predefinido, como Finanças.

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

Exemplos

Exemplo 1: Criar uma tag predefinida

New-AzTag -Name "FY2015"

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

Este comando cria uma tag predefinida chamada FY2015. Essa tag não tem valores. Você pode aplicar uma tag sem valores a um recurso ou grupo de recursos ou usar New-AzTag para adicionar valores à tag. Você também pode especificar um valor ao aplicar a tag 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

Este comando cria uma tag predefinida chamada Department com um valor de Finance.

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 tag existir, New-AzTag adiciona o valor à tag 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 tag predefinida.

Exemplo 5: Cria ou atualiza todo o conjunto de tags 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

Este comando cria ou atualiza todo o conjunto de tags na assinatura com {subId}.

Exemplo 6: Cria ou atualiza todo o conjunto de tags 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

Este comando cria ou atualiza todo o conjunto de tags no recurso com {resourceId}.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceId

O identificador de recurso para a entidade que está sendo marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Tag

As tags a serem colocadas no recurso.

Tipo:Hashtable
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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, porque as tags podem ter nomes sem valores.

Tipo:String
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Hashtable

Saídas

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