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]
[<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.
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.