Update-AzTag

Modul:
Az.Resources Module

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

Syntax

Default (Výchozí) 

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

Description

Rutina Update-AzTagselektivně 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

-AcquirePolicyToken

Získejte token Azure Policy automaticky pro tuto operaci prostředku.

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:False
Hodnota ze zbývajících argumentů:False

-ChangeReference

ID zdroje odkazu na změnu pro tuto operaci prostředku.

Vlastnosti parametru

Typ:String
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:False
Hodnota ze zbývajících argumentů:False

-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

-Operation

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

Vlastnosti parametru

Typ:TagPatchOperation
Default value:None
Přípustné hodnoty:Merge, Replace, Delete
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:2
Povinné:True
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ů

(All)
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

-Tag

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

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:True
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.

Vstupy

String

TagPatchOperation

Hashtable

Výstupy

PSTagResource