Remove-AzTag
Elimina i tag o i valori di Azure predefiniti | Elimina l'intero set di tag in una risorsa o una sottoscrizione.
Sintassi
RemovePredefinedTagParameterSet
Remove-AzTag
[-Name] <String>
[[-Value] <String[]>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveByResourceIdParameterSet
Remove-AzTag
-ResourceId <String>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
RemovePredefinedTagSet: il cmdlet Remove-AzTag elimina i tag e i valori di Azure predefiniti dalla sottoscrizione. Per eliminare valori specifici da un tag predefinito, usare il parametro Value . Per impostazione predefinita, Remove-AzTag elimina il tag specificato e tutti i relativi valori. Non è possibile eliminare un tag o un valore attualmente applicato a una risorsa o a un gruppo di risorse. Prima di usare Remove-AzTag, usare il parametro Tag del cmdlet Set-AzResourceGroup per eliminare il tag o i valori dalla risorsa o dal gruppo di risorse. Il modulo Tag di Azure che remove-AzTag fa parte di consente di gestire i tag di Azure predefiniti. Un tag di Azure è una coppia nome-valore che è possibile usare per classificare le risorse e i gruppi di risorse di Azure, ad esempio per reparto o centro di costo, oppure per tenere traccia di note o commenti relativi alle risorse e ai gruppi. È possibile definire e applicare tag in un singolo passaggio, ma i tag predefiniti consentono di definire nomi e valori standard, coerenti, prevedibili per i tag nella sottoscrizione.
RemoveByResourceIdParameterSet: il cmdlet Remove-AzTag con resourceId elimina l'intero set di tag in una risorsa o una sottoscrizione.
Esempio
Esempio 1: Eliminare un tag predefinito
Remove-AzTag -Name "Department"
Questo comando elimina il tag predefinito denominato Department e tutti i relativi valori. Se il tag è stato applicato a qualsiasi risorsa o gruppo di risorse, il comando ha esito negativo.
Esempio 2: Eliminare un valore da un tag predefinito
Remove-AzTag -Name "Department" -Value "HumanResources" -PassThru
Name: Department
Count: 14
Values:
Name Count
========= =====
Finance 2
IT 12
Questo comando elimina il valore HumanResources dal tag Department predefinito. Non elimina il tag. Se il valore è stato applicato a qualsiasi risorsa o gruppo di risorse, il comando ha esito negativo.
Esempio 3: Elimina l'intero set di tag in una sottoscrizione
Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Questo comando elimina l'intero set di tag nella sottoscrizione con {subId}. Non restituirà l'oggetto eliminato se non passa "-PassThru".
Esempio 4: Elimina l'intero set di tag in una risorsa
Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -PassThru
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
Dept Finance
Status Normal
Questo comando elimina l'intero set di tag nella risorsa con {resourceId}. Restituisce l'oggetto eliminato quando si passa "-PassThru".
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 |
-Name
Specifica il nome del tag predefinito da rimuovere. Per impostazione predefinita, Remove-AzTag rimuove il tag specificato e tutti i relativi valori. Per eliminare i valori selezionati, ma non eliminare il tag, usare il parametro Value .
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RemovePredefinedTagParameterSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Restituisce un oggetto che rappresenta il tag eliminato o il tag risultante con valore eliminato.
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à: | 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
RemoveByResourceIdParameterSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Value
Elimina i valori specificati dal tag predefinito, ma non elimina il tag.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RemovePredefinedTagParameterSet
| Posizione: | 1 |
| Obbligatorio: | False |
| 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.
