Remove-AzTag
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[]
Kimenetek
Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: