Freigeben über

Remove-AzTag

  • Referenz
Modul:
Az.Resources

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-: Mit dem Cmdlet Remove-AzTag werden vordefinierte Azure-Tags und -Werte aus Ihrem Abonnement gelöscht. Um bestimmte Werte aus einem vordefinierten Tag zu löschen, verwenden Sie den Parameter Value. 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. Bevor Sie Remove-AzTag-verwenden, verwenden Sie den Parameter Tag des Cmdlets Set-AzResourceGroup, um das Tag oder die Werte aus der Ressource oder Ressourcengruppe zu löschen. Das Azure Tags-Modul, das Remove-AzTag-, ist Teil der Möglichkeit, 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 den gesamten Satz von Tags für eine Ressource oder ein Abonnement löscht.

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

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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 passiert, 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