Update-AzTag
Aggiorna in modo selettivo il set di tag in una risorsa o una sottoscrizione.
Sintassi
Default (Impostazione predefinita)
Update-AzTag
[-ResourceId] <String>
[-Tag] <Hashtable>
[-Operation] <TagPatchOperation>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<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
-AcquirePolicyToken
Acquisire automaticamente un token di Criteri di Azure per questa operazione di risorsa.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-ChangeReference
ID risorsa di riferimento di modifica per questa operazione di risorsa.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False Supporta i caratteri jolly: False DontShow: False Alias: cfr
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Proprietà dei parametri
Tipo: IAzureContextContainer
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-Operation
Operazione di aggiornamento. Le opzioni sono Merge, Sostituisci ed Elimina.
Proprietà dei parametri
Tipo: TagPatchOperation
Valore predefinito: None Valori accettati: Merge, Replace, Delete Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: 2 Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-ResourceId
Identificatore della risorsa per l'entità contrassegnata. È possibile contrassegnare una risorsa, un gruppo di risorse o una sottoscrizione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: 0 Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-Tag
Set di tag da usare per l'aggiornamento.
Proprietà dei parametri
Tipo: Hashtable
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: 1 Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet.
Il cmdlet non viene eseguito.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False Supporta i caratteri jolly: False DontShow: False Alias: Wi
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters .
Output
