Update-AzTag
Atualiza seletivamente o conjunto de tags em um recurso ou assinatura.
Sintaxe
Default (Predefinição)
Update-AzTag
[-ResourceId] <String>
[-Tag] <Hashtable>
[-Operation] <TagPatchOperation>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
Descrição
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
$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".
$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".
$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
-AcquirePolicyToken
Adquira automaticamente um token Azure Policy para esta operação de recurso.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ChangeReference
A alteração do ID de referência do recurso para esta operação de recurso.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: False Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Operation
A operação de atualização. As opções são Mesclar, Substituir e Excluir.
Propriedades dos parâmetros
Tipo: TagPatchOperation
Valor predefinido: None Valores aceites: Merge, Replace, Delete Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ResourceId
O identificador de recurso para a entidade marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Tag
O conjunto de tags a serem usadas para atualização.
Propriedades dos parâmetros
Tipo: Hashtable
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: False Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
