Update-AzTag

  • Reference
Modul:
Az.Resources

Selektivně aktualizuje sadu značek pro prostředek nebo předplatné.

Syntax

Update-AzTag
      [-ResourceId] <String>
      [-Tag] <Hashtable>
      [-Operation] <TagPatchOperation>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Update-AzTag selektivně aktualizuje sadu značek pro prostředek nebo předplatné. Tato operace umožňuje nahradit, slučovat nebo selektivně odstraňovat značky u zadaného prostředku nebo předplatného. Zadaná entita může mít na konci operace maximálně 50 značek. Možnost nahradit nahradí celou sadu existujících značek novou sadou. Možnost sloučení umožňuje přidávat značky s novými názvy a aktualizovat hodnoty značek stávajícími názvy. Možnost Odstranit umožňuje selektivní odstranění značek na základě zadaných názvů nebo párů název/hodnota.

Příklady

Příklad 1: Selektivní aktualizace sady značek v předplatném pomocí operace Sloučení

$mergedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $mergedTags -Operation Merge

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key2     value2
             key3     value3

Tento příkaz sloučí sadu značek v předplatném s "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Příklad 2: Selektivní aktualizace sady značek v předplatném pomocí operace Nahradit

$replacedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $replacedTags -Operation Replace

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key3     value3

Tento příkaz nahradí sadu značek v předplatném výrazem xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Příklad 3: Selektivní aktualizace sady značek v předplatném pomocí operace Odstranit

$deletedTags = @{"key1"="value1"}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $deletedTags -Operation Delete

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key3     value3

Tento příkaz odstraní sadu značek v předplatném s výrazem xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx.

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

-Operation

Operace aktualizace. Možnosti jsou sloučení, nahrazení a odstranění.

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
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:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Sada značek, které se mají použít k aktualizaci.

Type:Hashtable
Position:1
Default value:None
Required:True
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

TagPatchOperation

Hashtable

Výstupy

PSTagResource