Update-AzTag

  • Referencia
Modul:
Az.Resources

Az erőforrás vagy előfizetés címkéinek készletét szelektíven frissíti.

Syntax

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

Description

A ResourceId azonosítóval rendelkező Update-AzTag parancsmag szelektíven frissíti az erőforrás vagy előfizetés címkéinek készletét. Ez a művelet lehetővé teszi a címkék cseréjét, egyesítését vagy szelektív törlését a megadott erőforráson vagy előfizetésen. A megadott entitás legfeljebb 50 címkével rendelkezhet a művelet végén. A "csere" beállítás a meglévő címkék teljes készletét új készletre cseréli. Az "egyesítés" lehetőség lehetővé teszi új névvel rendelkező címkék hozzáadását és a címkék értékeinek frissítését a meglévő névvel. A "törlés" lehetőség lehetővé teszi a címkék név vagy név/érték párok alapján történő szelektív törlését.

Példák

1. példa: Az előfizetés címkéinek szelektív frissítése az "Egyesítés" művelettel

$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

Ez a parancs egyesíti az előfizetés címkéit a következővel: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

2. példa: Az előfizetés címkéinek készletét szelektíven frissíti a "Csere" művelettel

$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

Ez a parancs lecseréli az előfizetés címkéit a következőre: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

3. példa: Az előfizetés címkéinek készletének szelektív frissítése a "Törlés" művelettel

$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

Ez a parancs törli az előfizetés címkéinek készletét a következővel: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-Operation

A frissítési művelet. A beállítások az egyesítés, a csere és a törlés.

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

-ResourceId

A címkézett entitás erőforrás-azonosítója. Előfordulhat, hogy egy erőforrás, egy erőforráscsoport vagy egy előfizetés címkézve van.

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

-Tag

A frissítéshez használandó címkék készlete.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

String

TagPatchOperation

Hashtable

Kimenetek

PSTagResource