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

RemovePredefinedTagParameterSet

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

RemoveByResourceIdParameterSet

Remove-AzTag
    -ResourceId <String>
    [-PassThru]
    [-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}. Det returnerar det borttagna objektet när det skickas i "-PassThru".

Parametrar

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 .

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RemovePredefinedTagParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PassThru

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RemoveByResourceIdParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Value

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RemovePredefinedTagParameterSet
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

String

SwitchParameter

Utdata

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