Freigeben über


Remove-AzTag

Löscht vordefinierte Azure-Tags oder -Werte | Löscht den gesamten Satz von Tags für eine Ressource oder ein Abonnement.

Syntax

Remove-AzTag
      [-Name] <String>
      [[-Value] <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzTag
      [-PassThru]
      -ResourceId <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

RemovePredefinedTagSet: Das Cmdlet Remove-AzTag löscht vordefinierte Azure-Tags und -Werte aus Ihrem Abonnement. Verwenden Sie den Parameter Value , um bestimmte Werte aus einem vordefinierten Tag zu löschen. Standardmäßig löscht Remove-AzTag das angegebene Tag und alle zugehörigen Werte. Sie können kein Tag oder einen Wert löschen, der derzeit auf eine Ressource oder Ressourcengruppe angewendet wird. Verwenden Sie vor der Verwendung von Remove-AzTag den Tag-Parameter des Cmdlets Set-AzResourceGroup, um das Tag oder die Werte aus der Ressource oder Ressourcengruppe zu löschen. Das Azure Tags-Modul, in dem Remove-AzTag enthalten ist, kann Ihnen helfen, Ihre vordefinierten Azure-Tags zu verwalten. Ein Azure-Tag ist ein Name-Wert-Paar, mit dem Sie Ihre Azure-Ressourcen und -Ressourcengruppen kategorisieren können, z. B. nach Abteilung oder Kostenstelle, oder um Notizen oder Kommentare zu den Ressourcen und Gruppen nachzuverfolgen. Sie können Tags in einem einzigen Schritt definieren und anwenden, aber mit vordefinierten Tags können Sie Standard-, konsistente, vorhersagbare Namen und Werte für die Tags in Ihrem Abonnement einrichten.

RemoveByResourceIdParameterSet: Das Cmdlet Remove-AzTag mit einer ResourceId löscht den gesamten Satz von Tags für eine Ressource oder ein Abonnement.

Beispiele

Beispiel 1: Löschen eines vordefinierten Tags

Remove-AzTag -Name "Department"

Mit diesem Befehl wird das vordefinierte Tag "Abteilung" und alle zugehörigen Werte gelöscht. Wenn das Tag auf Ressourcen oder Ressourcengruppen angewendet wurde, schlägt der Befehl fehl.

Beispiel 2: Löschen eines Werts aus einem vordefinierten Tag

Remove-AzTag -Name "Department" -Value "HumanResources" -PassThru

Name:   Department
Count:  14
Values: 

        Name        Count
        =========   =====

        Finance        2
        IT            12

Mit diesem Befehl wird der HumanResources-Wert aus dem vordefinierten Department-Tag gelöscht. Das Tag wird nicht gelöscht. Wenn der Wert auf Ressourcen oder Ressourcengruppen angewendet wurde, schlägt der Befehl fehl.

Beispiel 3: Löscht den gesamten Satz von Tags in einem Abonnement.

Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Mit diesem Befehl wird der gesamte Satz von Tags für das Abonnement mit {subId} gelöscht. Das Objekt wird nicht zurückgegeben, wenn es nicht "-PassThru" übergibt.

Beispiel 4: Löscht den gesamten Satz von Tags für eine Ressource.

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

Mit diesem Befehl wird der gesamte Satz von Tags für die Ressource mit {resourceId} gelöscht. Beim Übergeben von "-PassThru" wird das gelöschte Oject zurückgegeben.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des zu entfernenden vordefinierten Tags an. Standardmäßig entfernt Remove-AzTag das angegebene Tag und alle zugehörigen Werte. Um ausgewählte Werte zu löschen, aber nicht das Tag zu löschen, verwenden Sie den Parameter Value .

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das gelöschte Tag oder das resultierende Tag mit gelöschten Werten darstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Der Ressourcenbezeichner für die markierte Entität. Eine Ressource, eine Ressourcengruppe oder ein Abonnement kann markiert werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Value

Löscht die angegebenen Werte aus dem vordefinierten Tag, löscht jedoch nicht das Tag.

Typ:String[]
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

String[]

SwitchParameter

Ausgaben

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