Remove-AzTag
Odstraní předdefinované značky nebo hodnoty Azure | Odstraní celou sadu značek u prostředku nebo předplatného.
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: Rutina Remove-AzTag odstraní předdefinované značky a hodnoty Azure z vašeho předplatného. Pokud chcete odstranit konkrétní hodnoty z předdefinované značky, použijte parametr Value . Ve výchozím nastavení Remove-AzTag odstraní zadanou značku a všechny její hodnoty. Nelze odstranit značku nebo hodnotu, která je aktuálně použita pro prostředek nebo skupinu prostředků. Před použitím Remove-AzTag pomocí parametru Tag rutiny Set-AzResourceGroup odstraňte značku nebo hodnoty z prostředku nebo skupiny prostředků. Modul Značky Azure, který remove-AzTag je součástí, vám může pomoct se správou předdefinovanýchzch Značka Azure je pár název-hodnota, který můžete použít ke kategorizaci prostředků a skupin prostředků Azure, jako jsou oddělení nebo nákladové středisko, nebo ke sledování poznámek nebo komentářů k prostředkům a skupinám. Značky můžete definovat a používat v jednom kroku, ale předdefinované značky umožňují vytvořit standardní, konzistentní, předvídatelné názvy a hodnoty pro značky ve vašem předplatném.
RemoveByResourceIdParameterSet: Rutina Remove-AzTag s ID prostředku odstraní celou sadu značek v prostředku nebo předplatném.
Příklady
Příklad 1: Odstranění předdefinované značky
Remove-AzTag -Name "Department"
Tento příkaz odstraní předdefinovanou značku s názvem Oddělení a všechny její hodnoty. Pokud byla značka použita pro všechny prostředky nebo skupiny prostředků, příkaz selže.
Příklad 2: Odstranění hodnoty z předdefinované značky
Remove-AzTag -Name "Department" -Value "HumanResources" -PassThru
Name: Department
Count: 14
Values:
Name Count
========= =====
Finance 2
IT 12
Tento příkaz odstraní hodnotu HumanResources z předdefinované značky Oddělení. Neodstraní značku. Pokud byla hodnota použita pro všechny prostředky nebo skupiny prostředků, příkaz selže.
Příklad 3: Odstraní celou sadu značek v předplatném.
Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tento příkaz odstraní celou sadu značek v předplatném s {subId}. Objekt se nevrátí, pokud se nepředává "-PassThru".
Příklad 4: Odstraní celou sadu značek prostředku.
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
Tento příkaz odstraní celou sadu značek prostředku pomocí {resourceId}. Vrátí odstraněný objekt při předávání "-PassThru".
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Vlastnosti parametru
| Typ: | IAzureContextContainer |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje název předdefinované značky, která se má odebrat. Ve výchozím nastavení Remove-AzTag odebere zadanou značku a všechny její hodnoty. Pokud chcete odstranit vybrané hodnoty, ale neodstraňovat značku, použijte parametr Value .
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
RemovePredefinedTagParameterSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt, který představuje odstraněnou značku nebo výslednou značku s odstraněnou hodnotou.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ResourceId
Identifikátor prostředku pro označenou entitu. Prostředek, skupina prostředků nebo předplatné můžou být označené.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
RemoveByResourceIdParameterSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Value
Odstraní zadané hodnoty z předdefinované značky, ale neodstraní značku.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
RemovePredefinedTagParameterSet
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
