Compartilhar via

Update-AzTag

  • Referência
Módulo:
Az.Resources

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 marcas no recurso ou assinatura especificado. A entidade especificada pode ter no máximo 50 marcas no final da operação. A opção 'replace' substitui todo o conjunto de marcas existentes por um novo conjunto. A opção 'merge' permite adicionar marcas com novos nomes e atualizar os valores de marcas com nomes existentes. A opção 'delete' permite excluir seletivamente marcas com base em determinados nomes ou pares nome/valor.

Exemplos

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

$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-xxxx-xxxxxx".

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

Esse comando substitui o conjunto de marcas na assinatura por "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxx".

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

$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

Esse comando exclui o conjunto de marcas na assinatura com "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxx".

Parâmetros

-Confirm

Solicita a 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 Mesclagem, Substituição e Exclusão.

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 podem ser marcados.

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