Compartilhar via


Update-AzTag

Atualiza seletivamente o conjunto de marcas em um recurso ou assinatura.

Sintaxe

Update-AzTag
      [-ResourceId] <String>
      [-Tag] <Hashtable>
      [-Operation] <TagPatchOperation>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-AzTag com um ResourceId atualiza seletivamente o conjunto de marcas em um recurso ou assinatura. Essa operação permite substituir, mesclar ou excluir seletivamente tags no recurso ou assinatura especificado. A entidade especificada pode ter no máximo 50 marcas no final da operação. A opção 'substituir' substitui todo o conjunto de tags existentes por um novo conjunto. A opção 'merge' permite adicionar tags com novos nomes e atualizar os valores das tags com nomes existentes. A opção 'excluir' permite excluir seletivamente tags com base em nomes próprios ou pares de nome/valor.

Exemplos

Exemplo 1: atualiza seletivamente o conjunto de marcas em uma assinatura com a operação "Mesclar"

$mergedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $mergedTags -Operation Merge

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key2     value2
             key3     value3

Esse comando mescla o conjunto de marcas na assinatura com "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Exemplo 2: atualiza seletivamente o conjunto de marcas em uma assinatura com a operação "Substituir"

$replacedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $replacedTags -Operation Replace

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key3     value3

Este comando substitui o conjunto de marcas na assinatura por "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Exemplo 3: atualiza seletivamente o conjunto de marcas em uma assinatura com a operação "Excluir"

$deletedTags = @{"key1"="value1"}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $deletedTags -Operation Delete

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key3     value3

Este comando exclui o conjunto de marcas na assinatura com "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

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

-Operation

A operação de atualização. As opções são Mesclar, Substituir e Excluir.

Tipo:TagPatchOperation
Valores aceitos:Merge, Replace, Delete
Cargo:2
Valor padrão:None
Obrigatório:True
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:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tag

O conjunto de marcas a serem usadas para atualização.

Tipo:Hashtable
Cargo:1
Valor padrão:None
Obrigatório:True
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

TagPatchOperation

Hashtable

Saídas

PSTagResource