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.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Operation

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

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

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

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

-Tag

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

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

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

Indata

String

TagPatchOperation

Hashtable

Utdata

PSTagResource