Update-AzTag

  • Referentie
Module:
Az.Resources

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

Syntax

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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

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

-Operation

De updatebewerking. Opties zijn Samenvoegen, Vervangen en Verwijderen.

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

De set tags die moeten worden gebruikt voor update.

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

-WhatIf

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

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

Invoerwaarden

String

TagPatchOperation

Hashtable

Uitvoerwaarden

PSTagResource