Dela via


Remove-AzTag

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.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 .

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Value

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

Typ:String[]
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

String[]

SwitchParameter

Utdata

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