Update-AzTag
Uppdaterar selektivt uppsättningen taggar för en resurs eller prenumeration.
Syntax
Default (Standard)
Update-AzTag
[-ResourceId] <String>
[-Tag] <Hashtable>
[-Operation] <TagPatchOperation>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<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
-AcquirePolicyToken
Hämta en Azure Policy token automatiskt för den här resursåtgärden.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-ChangeReference
Resurs-ID för ändringsreferens för den här resursåtgärden.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: False Stöder jokertecken: False DontShow: False Alias: jfr
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Parameteregenskaper
Typ: IAzureContextContainer
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Operation
Uppdateringsåtgärden. Alternativen är Sammanfoga, Ersätt och Ta bort.
Parameteregenskaper
Typ: TagPatchOperation
Standardvärde: None Godkända värden: Merge, Replace, Delete Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: 2 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-ResourceId
Resursidentifieraren för den taggade entiteten. En resurs, en resursgrupp eller en prenumeration kan vara taggade.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-Tag
Uppsättningen taggar som ska användas för uppdatering.
Parameteregenskaper
Typ: Hashtable
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: 1 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-WhatIf
Visar vad som skulle hända om kommandot körs.
Cmdleten körs inte.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: False Stöder jokertecken: False DontShow: False Alias: Wi
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utdata
