Remove-AzTag

  • Referencia
Modul:
Az.Resources

Előre definiált Azure-címkék vagy -értékek törlése | Egy erőforrás vagy előfizetés címkéinek teljes készletét törli.

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: A Remove-AzTag parancsmag törli az előre definiált Azure-címkéket és -értékeket az előfizetésből. Ha egy előre definiált címkéből szeretne bizonyos értékeket törölni, használja az Érték paramétert. Alapértelmezés szerint az Remove-AzTag törli a megadott címkét és annak összes értékét. Egy erőforrásra vagy erőforráscsoportra jelenleg alkalmazott címke vagy érték nem törölhető. Az Remove-AzTag használata előtt a Set-AzResourceGroup parancsmag Címke paraméterével törölje a címkét vagy értékeket az erőforrásból vagy erőforráscsoportból. A Remove-AzTag részét képező Azure Tags modul segíthet az előre definiált Azure-címkék kezelésében. Az Azure-címke egy név-érték pár, amellyel kategorizálhatja az Azure-erőforrásokat és erőforráscsoportokat, például részlegek vagy költséghely szerint, illetve nyomon követheti az erőforrásokkal és csoportokkal kapcsolatos megjegyzéseket vagy megjegyzéseket. Címkéket egyetlen lépésben definiálhat és alkalmazhat, de az előre definiált címkék lehetővé teszik az előfizetésben lévő címkék szabványos, konzisztens, kiszámítható neveinek és értékeinek létrehozását.

RemoveByResourceIdParameterSet: A ResourceId-et tartalmazó Remove-AzTag parancsmag törli egy erőforrás vagy előfizetés címkéinek teljes készletét.

Példák

1. példa: Előre definiált címke törlése

Remove-AzTag -Name "Department"

Ez a parancs törli a Részleg nevű előre definiált címkét és annak összes értékét. Ha a címkét bármilyen erőforrásra vagy erőforráscsoportra alkalmazták, a parancs meghiúsul.

2. példa: Érték törlése előre definiált címkéből

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

Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

Ez a parancs törli a HumanResources értéket az előre definiált részlegcímkéből. Nem törli a címkét. Ha az értéket bármilyen erőforrásra vagy erőforráscsoportra alkalmazták, a parancs meghiúsul.

3. példa: Az előfizetés teljes címkekészletének törlése

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

Ez a parancs törli az előfizetés teljes címkéit a(z) {subId} paranccsal. Nem adja vissza a törölt objektumot, ha nem adja át a "-PassThru" értéket.

4. példa: Az erőforrás teljes címkekészletének törlése

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

Ez a parancs törli az erőforrás teljes címkéit a(z) {resourceId} paranccsal. A törölt oject értéket adja vissza a "-PassThru" átadásakor.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-Name

Megadja az eltávolítandó előre definiált címke nevét. Alapértelmezés szerint az Remove-AzTag eltávolítja a megadott címkét és annak összes értékét. A kijelölt értékek törléséhez, de a címke törléséhez használja az Érték paramétert.

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

-PassThru

Olyan objektumot ad vissza, amely a törölt vagy az eredményül kapott címkét jelöli törölt értékkel.

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

-ResourceId

A címkézett entitás erőforrás-azonosítója. Előfordulhat, hogy egy erőforrás, egy erőforráscsoport vagy egy előfizetés címkézve van.

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

-Value

Törli a megadott értékeket az előre definiált címkéből, de nem törli a címkét.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

String

String[]

SwitchParameter

Kimenetek

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