Megosztás a következőn keresztül:

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.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

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

Típus:IAzureContextContainer
Aliasok:AzContext, AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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.

Típus:String[]
Position:1
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

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

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

String[]

SwitchParameter

Kimenetek

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