Sdílet prostřednictvím

Update-AzTag

  • Reference
Modul:
Az.Resources

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

Syntaxe

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

Description

Rutina Update-AzTag s id prostředku 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 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

-Operation

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

Typ:TagPatchOperation
Přípustné hodnoty:Merge, Replace, Delete
Position:2
Default value:None
Vyžadováno:True
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:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

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

Typ:Hashtable
Position:1
Default value:None
Vyžadováno:True
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

TagPatchOperation

Hashtable

Výstupy

PSTagResource