Condividi tramite

Remove-AzTag

  • Riferimento
Modulo:
Az.Resources

Elimina i tag o i valori di Azure predefiniti | Elimina l'intero set di tag in una risorsa o una sottoscrizione.

Sintassi

Remove-AzTag
      [-Name] <String>
      [[-Value] <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzTag
      [-PassThru]
      -ResourceId <String>
      [-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'oject eliminato quando si passa "-PassThru".

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 .

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta il tag eliminato o il tag risultante con valore eliminato.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Value

Elimina i valori specificati dal tag predefinito, ma non elimina il tag.

Tipo:String[]
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

String[]

SwitchParameter

Output

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource