Update-AzTag
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.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Operation
A frissítési művelet. A beállítások az egyesítés, a csere és a törlés.
Típus: | TagPatchOperation |
Elfogadott értékek: | Merge, Replace, Delete |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Tag
A frissítéshez használandó címkék készlete.
Típus: | Hashtable |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |