Bagikan melalui

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.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Operation

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

Jenis:TagPatchOperation
Nilai yang diterima:Merge, Replace, Delete
Position:2
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ResourceId

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

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Tag

Kumpulan tag yang akan digunakan untuk pembaruan.

Jenis:Hashtable
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

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

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

TagPatchOperation

Hashtable

Output

PSTagResource