Update-AzTag

  • Referência
Módulo:
Az.Resources

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

Syntax

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. Esta operação permite substituir, mesclar ou excluir seletivamente tags no recurso ou assinatura especificados. A entidade especificada pode ter um máximo de 50 tags no final da operação. A opção 'substituir' substitui todo o conjunto de tags existentes por um novo conjunto. A opção 'mesclar' permite adicionar tags com novos nomes e atualizar os valores das tags com nomes existentes. A opção «eliminar» permite eliminar seletivamente etiquetas com base em nomes próprios ou pares nome/valor.

Exemplos

Exemplo 1: Atualiza seletivamente o conjunto de tags 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

Este comando: Mescla o conjunto de tags na assinatura com "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Exemplo 2: Atualiza seletivamente o conjunto de tags 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 tags na assinatura por "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Exemplo 3: Atualiza seletivamente o conjunto de tags 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 tags na assinatura com "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Parâmetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Operation

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

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

TagPatchOperation

Hashtable

Saídas

PSTagResource