Share via

Remove-AzTag

  • Referens
Modul:
Az.Resources

Tar bort fördefinierade Azure-taggar eller -värden | Tar bort hela uppsättningen taggar för en resurs eller prenumeration.

Syntax

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

Description

RemovePredefinedTagSet: Cmdleten Remove-AzTag tar bort fördefinierade Azure-taggar och -värden från din prenumeration. Om du vill ta bort vissa värden från en fördefinierad tagg använder du parametern Värde . Som standard tar Remove-AzTag bort den angivna taggen och alla dess värden. Du kan inte ta bort en tagg eller ett värde som för närvarande tillämpas på en resurs eller resursgrupp. Innan du använder Remove-AzTag använder du taggparametern för cmdleten Set-AzResourceGroup för att ta bort taggen eller värdena från resursen eller resursgruppen. Modulen Azure Tags som Remove-AzTag ingår i kan hjälpa dig att hantera dina fördefinierade Azure-taggar. En Azure-tagg är ett namn/värde-par som du kan använda för att kategorisera dina Azure-resurser och resursgrupper, till exempel efter avdelning eller kostnadsställe, eller för att spåra anteckningar eller kommentarer om resurser och grupper. Du kan definiera och tillämpa taggar i ett enda steg, men med fördefinierade taggar kan du upprätta standard, konsekventa, förutsägbara namn och värden för taggarna i din prenumeration.

RemoveByResourceIdParameterSet: Cmdleten Remove-AzTag med ett ResourceId tar bort hela uppsättningen taggar för en resurs eller prenumeration.

Exempel

Exempel 1: Ta bort en fördefinierad tagg

Remove-AzTag -Name "Department"

Det här kommandot tar bort den fördefinierade taggen med namnet Department och alla dess värden. Om taggen har tillämpats på resurser eller resursgrupper misslyckas kommandot.

Exempel 2: Ta bort ett värde från en fördefinierad tagg

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

Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

Det här kommandot tar bort humanresources-värdet från den fördefinierade avdelningstaggen. Taggen tas inte bort. Om värdet har tillämpats på resurser eller resursgrupper misslyckas kommandot.

Exempel 3: Tar bort hela uppsättningen taggar i en prenumeration

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

Det här kommandot tar bort hela uppsättningen taggar i prenumerationen med {subId}. Det returnerar inte objektet som tas bort om det inte skickas i "-PassThru".

Exempel 4: Tar bort hela uppsättningen taggar på en resurs

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

Det här kommandot tar bort hela uppsättningen taggar på resursen med {resourceId}. Den returnerar den borttagna ojecten när du skickar in "-PassThru".

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Anger namnet på den fördefinierade taggen som ska tas bort. Som standard tar Remove-AzTag bort den angivna taggen och alla dess värden. Om du vill ta bort markerade värden, men inte ta bort taggen, använder du parametern Värde .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Returnerar ett objekt som representerar den borttagna taggen eller den resulterande taggen med borttaget värde.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Resursidentifieraren för den taggade entiteten. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Value

Tar bort de angivna värdena från den fördefinierade taggen, men tar inte bort taggen.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

String[]

SwitchParameter

Utdata

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