Delen via

Update-AzTag

  • Referentie
Module:
Az.Resources

Hiermee wordt de set tags voor een resource of abonnement selectief bijgewerkt.

Syntaxis

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

Description

Met de cmdlet Update-AzTag met een ResourceId wordt de set tags voor een resource of abonnement selectief bijgewerkt. Met deze bewerking kunt u tags voor de opgegeven resource of het opgegeven abonnement vervangen, samenvoegen of selectief verwijderen. De opgegeven entiteit kan maximaal 50 tags aan het einde van de bewerking hebben. De optie Vervangen vervangt de hele set bestaande tags door een nieuwe set. Met de optie 'samenvoegen' kunt u tags met nieuwe namen toevoegen en de waarden van tags bijwerken met bestaande namen. Met de optie Verwijderen kunnen tags selectief worden verwijderd op basis van namen of naam-/waardeparen.

Voorbeelden

Voorbeeld 1: De set tags voor een abonnement selectief bijwerken met bewerking Samenvoegen

$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

Met deze opdracht wordt de set tags voor het abonnement samengevoegd met 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'.

Voorbeeld 2: De set tags voor een abonnement selectief bijwerken met de bewerking Vervangen

$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

Met deze opdracht wordt de set tags in het abonnement vervangen door 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'.

Voorbeeld 3: De set tags voor een abonnement selectief bijwerken met bewerking Verwijderen

$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

Met deze opdracht verwijdert u de set tags in het abonnement met 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Operation

De updatebewerking. Opties zijn Samenvoegen, Vervangen en Verwijderen.

Type:TagPatchOperation
Geaccepteerde waarden:Merge, Replace, Delete
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

De resource-id voor de getagde entiteit. Een resource, een resourcegroep of een abonnement kan worden getagd.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

De set tags die moeten worden gebruikt voor update.

Type:Hashtable
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

TagPatchOperation

Hashtable

Uitvoerwaarden

PSTagResource