Dela via

Update-AzTag

  • Referens
Modul:
Az.Resources

Uppdaterar selektivt uppsättningen taggar för en resurs eller prenumeration.

Syntax

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

Description

Cmdleten Update-AzTag med ett ResourceId uppdaterar selektivt uppsättningen taggar för en resurs eller prenumeration. Med den här åtgärden kan du ersätta, slå samman eller selektivt ta bort taggar på den angivna resursen eller prenumerationen. Den angivna entiteten kan ha högst 50 taggar i slutet av åtgärden. Alternativet Ersätt ersätter hela uppsättningen befintliga taggar med en ny uppsättning. Alternativet "sammanfogning" gör det möjligt att lägga till taggar med nya namn och uppdatera värdena för taggar med befintliga namn. Alternativet "ta bort" tillåter selektiv borttagning av taggar baserat på förnamn eller namn/värde-par.

Exempel

Exempel 1: Selektivt uppdaterar uppsättningen taggar för en prenumeration med åtgärden "Slå samman"

$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

Det här kommandot sammanfogar uppsättningen taggar i prenumerationen med "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx".

Exempel 2: Selektivt uppdaterar uppsättningen taggar för en prenumeration med åtgärden Ersätt

$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

Det här kommandot ersätter uppsättningen taggar i prenumerationen med "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx".

Exempel 3: Selektivt uppdaterar uppsättningen taggar för en prenumeration med åtgärden Ta bort

$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

Det här kommandot Tar bort uppsättningen taggar i prenumerationen med "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx".

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Operation

Uppdateringsåtgärden. Alternativen är Sammanfoga, Ersätt och Ta bort.

Typ:TagPatchOperation
Godkända värden:Merge, Replace, Delete
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceId

Resursidentifieraren för den taggade entiteten. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Tag

Uppsättningen taggar som ska användas för uppdatering.

Typ:Hashtable
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

TagPatchOperation

Hashtable

Utdata

PSTagResource