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.

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

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-PassThru

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

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

-ResourceId

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

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

-Value

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

String[]

SwitchParameter

Výstupy

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