Update-AzTag

  • Riferimento
Modulo:
Az.Resources

Aggiorna in modo selettivo il set di tag in una risorsa o una sottoscrizione.

Sintassi

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

Descrizione

Il cmdlet Update-AzTag con resourceId aggiorna in modo selettivo il set di tag in una risorsa o una sottoscrizione. Questa operazione consente di sostituire, unire o eliminare in modo selettivo i tag nella risorsa o nella sottoscrizione specificata. L'entità specificata può avere un massimo di 50 tag alla fine dell'operazione. L'opzione 'replace' sostituisce l'intero set di tag esistenti con un nuovo set. L'opzione 'merge' consente di aggiungere tag con nuovi nomi e aggiornare i valori dei tag con nomi esistenti. L'opzione 'delete' consente di eliminare in modo selettivo i tag in base a nomi o coppie nome/valore specificati.

Esempio

Esempio 1: aggiorna in modo selettivo il set di tag in una sottoscrizione con operazione "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

Questo comando unisce il set di tag nella sottoscrizione con "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx".

Esempio 2: aggiorna in modo selettivo il set di tag in una sottoscrizione con l'operazione "Sostituisci"

$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

Questo comando Sostituisce il set di tag nella sottoscrizione con "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx".

Esempio 3: aggiorna in modo selettivo il set di tag in una sottoscrizione con l'operazione "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

Questo comando Elimina il set di tag nella sottoscrizione con "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx".

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-Operation

Operazione di aggiornamento. Le opzioni sono Merge, Sostituisci ed Elimina.

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

-ResourceId

Identificatore della risorsa per l'entità contrassegnata. È possibile contrassegnare una risorsa, un gruppo di risorse o una sottoscrizione.

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

-Tag

Set di tag da usare per l'aggiornamento.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

TagPatchOperation

Hashtable

Output

PSTagResource