Delen via


Remove-AzTag

Vooraf gedefinieerde Azure-tags of -waarden verwijderen | Hiermee verwijdert u de hele set tags voor een resource of abonnement.

Syntaxis

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

Description

RemovePredefinedTagSet: De cmdlet Remove-AzTag verwijdert vooraf gedefinieerde Azure-tags en -waarden uit uw abonnement. Als u bepaalde waarden uit een vooraf gedefinieerde tag wilt verwijderen, gebruikt u de parameter Waarde . Met Remove-AzTag worden standaard de opgegeven tag en alle bijbehorende waarden verwijderd. U kunt een tag of waarde die momenteel wordt toegepast op een resource of resourcegroep niet verwijderen. Voordat u Remove-AzTag gebruikt, gebruikt u de tagparameter van de cmdlet Set-AzResourceGroup om de tag of waarden uit de resource of resourcegroep te verwijderen. De Azure Tags-module waarvan Remove-AzTag deel uitmaakt, kan u helpen uw vooraf gedefinieerde Azure-tags te beheren. Een Azure-tag is een naam-waardepaar dat u kunt gebruiken om uw Azure-resources en resourcegroepen, zoals per afdeling of kostenplaats, te categoriseren of notities of opmerkingen over de resources en groepen bij te houden. U kunt tags in één stap definiëren en toepassen, maar met vooraf gedefinieerde tags kunt u standaard, consistente, voorspelbare namen en waarden instellen voor de tags in uw abonnement.

RemoveByResourceIdParameterSet: De cmdlet Remove-AzTag met een ResourceId verwijdert de volledige set tags voor een resource of abonnement.

Voorbeelden

Voorbeeld 1: Een vooraf gedefinieerde tag verwijderen

Remove-AzTag -Name "Department"

Met deze opdracht verwijdert u de vooraf gedefinieerde tag Department en alle bijbehorende waarden. Als de tag is toegepast op resources of resourcegroepen, mislukt de opdracht.

Voorbeeld 2: Een waarde verwijderen uit een vooraf gedefinieerde tag

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

Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

Met deze opdracht wordt de waarde HumanResources verwijderd uit de vooraf gedefinieerde afdelingstag. De tag wordt niet verwijderd. Als de waarde is toegepast op resources of resourcegroepen, mislukt de opdracht.

Voorbeeld 3: Hiermee verwijdert u de hele set tags voor een abonnement

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

Met deze opdracht verwijdert u de volledige set tags voor het abonnement met {subId}. Het object wordt niet geretourneerd als het niet wordt doorgegeven aan '-PassThru'.

Voorbeeld 4: Hiermee verwijdert u de hele set tags op een resource

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

Met deze opdracht verwijdert u de volledige set tags op de resource met {resourceId}. Het verwijderde werp wordt geretourneerd bij het doorgeven van '-PassThru'.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de vooraf gedefinieerde tag te verwijderen. Standaard verwijdert Remove-AzTag de opgegeven tag en alle bijbehorende waarden. Als u geselecteerde waarden wilt verwijderen, maar de tag niet wilt verwijderen, gebruikt u de parameter Waarde .

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Retourneert een object dat de verwijderde tag of de resulterende tag vertegenwoordigt met een verwijderde waarde.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

De resource-id voor de getagde entiteit. Een resource, een resourcegroep of een abonnement kan worden getagd.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Value

Hiermee verwijdert u de opgegeven waarden uit de vooraf gedefinieerde tag, maar verwijdert u de tag niet.

Type:String[]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

String[]

SwitchParameter

Uitvoerwaarden

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