Update-AzTag

  • Referensi
Modul:
Az.Resources

Secara selektif memperbarui kumpulan tag pada sumber daya atau langganan.

Sintaks

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

Deskripsi

Cmdlet Update-AzTag dengan ResourceId secara selektif memperbarui kumpulan tag pada sumber daya atau langganan. Operasi ini memungkinkan mengganti, menggabungkan, atau secara selektif menghapus tag pada sumber daya atau langganan yang ditentukan. Entitas yang ditentukan dapat memiliki maksimum 50 tag di akhir operasi. Opsi 'ganti' menggantikan seluruh set tag yang ada dengan set baru. Opsi 'gabung' memungkinkan penambahan tag dengan nama baru dan memperbarui nilai tag dengan nama yang ada. Opsi 'hapus' memungkinkan penghapusan tag secara selektif berdasarkan nama atau pasangan nama/nilai yang diberikan.

Contoh

Contoh 1: Secara selektif memperbarui kumpulan tag pada langganan dengan Operasi "Gabungkan"

$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

Perintah ini Menggabungkan kumpulan tag pada langganan dengan "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx".

Contoh 2: Secara selektif memperbarui kumpulan tag pada langganan dengan Operasi "Ganti"

$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

Perintah ini Menggantikan kumpulan tag pada langganan dengan "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx".

Contoh 3: Memperbarui kumpulan tag secara selektif pada langganan dengan Operasi "Hapus"

$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

Perintah ini Menghapus kumpulan tag pada langganan dengan "xxxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx".

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

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

-Operation

Operasi pembaruan. Opsinya adalah Gabungkan, Ganti, dan Hapus.

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

-ResourceId

Pengidentifikasi sumber daya untuk entitas yang ditandai. Sumber daya, grup sumber daya, atau langganan mungkin ditandai.

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

-Tag

Kumpulan tag yang akan digunakan untuk pembaruan.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

String

TagPatchOperation

Hashtable

Output

PSTagResource