Dela via

Remove-AzureRmTag

  • Referens
Modul:
AzureRM.Tags

Tar bort fördefinierade Azure-taggar eller -värden.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Description

Cmdleten Remove-AzureRmTag 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-AzureRmTag 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-AzureRmTag använder du taggparametern för cmdleten Set-AzureRMResourceGroup för att ta bort taggen eller värdena från resursen eller resursgruppen. Modulen Azure Tags som Remove-AzureRmTag 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.

Exempel

Exempel 1: Ta bort en fördefinierad tagg

PS C:\>Remove-AzureRmTag -Name "Department"

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

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

PS C:\>Remove-AzureRmTag -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.

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:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Anger namnet på taggen som ska tas bort. Som standard tar Remove-AzureRmTag 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

-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

PSTag