Sdílet prostřednictvím

Remove-AzTag

  • Reference
Modul:
Az.Resources

Odstraní předdefinované značky nebo hodnoty Azure | Odstraní celou sadu značek u prostředku nebo předplatného.

Syntaxe

Remove-AzTag
      [-Name] <String>
      [[-Value] <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzTag
      [-PassThru]
      -ResourceId <String>
      [-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-AzTagpoužijte parametr Tag rutiny Set-AzResourceGroup k odstranění značky nebo hodnot z prostředku nebo skupiny prostředků. Modul Značky Azure, který Remove-AzTag je součástí, vám může pomoct spravovat předdefinované značky Azure. 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 ResourceId odstraní celou sadu značek prostředku nebo předplatného.

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ěnou oject při předávání "-PassThru".

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Vrátí objekt, který představuje odstraněnou značku nebo výslednou značku s odstraněnou hodnotou.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceId

Identifikátor prostředku pro označenou entitu. Prostředek, skupina prostředků nebo předplatné můžou být označené.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Value

Odstraní zadané hodnoty z předdefinované značky, ale neodstraní značku.

Typ:String[]
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

String[]

SwitchParameter

Výstupy

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