Bagikan melalui

Remove-AzTag

  • Referensi
Modul:
Az.Resources

Menghapus tag atau nilai Azure yang telah ditentukan sebelumnya | Menghapus seluruh kumpulan tag pada sumber daya atau langganan.

Sintaks

Remove-AzTag
      [-Name] <String>
      [[-Value] <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzTag
      [-PassThru]
      -ResourceId <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

RemovePredefinedTagSet: Cmdlet Remove-AzTag menghapus tag dan nilai Azure yang telah ditentukan sebelumnya dari langganan Anda. Untuk menghapus nilai tertentu dari tag yang telah ditentukan sebelumnya, gunakan parameter Nilai . Secara default, Remove-AzTag menghapus tag yang ditentukan dan semua nilainya. Anda tidak dapat menghapus tag atau nilai yang saat ini diterapkan ke grup sumber daya atau sumber daya. Sebelum menggunakan Remove-AzTag, gunakan parameter Tag cmdlet Set-AzResourceGroup untuk menghapus tag atau nilai dari grup sumber daya atau sumber daya. Modul Tag Azure yang merupakan bagian dari Remove-AzTag dapat membantu Anda mengelola tag Azure yang telah ditentukan sebelumnya. Tag Azure adalah pasangan nama-nilai yang dapat Anda gunakan untuk mengategorikan sumber daya Azure dan grup sumber daya Anda, seperti berdasarkan departemen atau pusat biaya, atau untuk melacak catatan atau komentar tentang sumber daya dan grup. Anda dapat menentukan dan menerapkan tag dalam satu langkah, tetapi tag yang telah ditentukan memungkinkan Anda menetapkan nama dan nilai standar, konsisten, dan dapat diprediksi untuk tag dalam langganan Anda.

RemoveByResourceIdParameterSet: Cmdlet Remove-AzTag dengan ResourceId menghapus seluruh kumpulan tag pada sumber daya atau langganan.

Contoh

Contoh 1: Menghapus tag yang telah ditentukan sebelumnya

Remove-AzTag -Name "Department"

Perintah ini menghapus tag yang telah ditentukan sebelumnya bernama Departemen dan semua nilainya. Jika tag telah diterapkan ke sumber daya atau grup sumber daya apa pun, perintah gagal.

Contoh 2: Menghapus nilai dari tag yang telah ditentukan sebelumnya

Remove-AzTag -Name "Department" -Value "HumanResources" -PassThru

Name:   Department
Count:  14
Values: 

        Name        Count
        =========   =====

        Finance        2
        IT            12

Perintah ini menghapus nilai HumanResources dari tag Departemen yang telah ditentukan sebelumnya. Ini tidak menghapus tag. Jika nilai telah diterapkan ke sumber daya atau grup sumber daya apa pun, perintah gagal.

Contoh 3: Menghapus seluruh kumpulan tag pada langganan

Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Perintah ini menghapus seluruh set tag pada langganan dengan {subId}. Ini tidak akan mengembalikan objek yang dihapus jika tidak meneruskan "-PassThru".

Contoh 4: Menghapus seluruh kumpulan tag pada sumber daya

Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -PassThru

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Perintah ini menghapus seluruh kumpulan tag pada sumber daya dengan {resourceId}. Ini mengembalikan okte yang dihapus saat meneruskan "-PassThru".

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

-Name

Menentukan Nama tag yang telah ditentukan sebelumnya untuk dihapus. Secara default, Remove-AzTag menghapus tag yang ditentukan dan semua nilainya. Untuk menghapus nilai yang dipilih, tetapi tidak menghapus tag, gunakan parameter Nilai .

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

-PassThru

Mengembalikan objek yang mewakili tag yang dihapus atau tag yang dihasilkan dengan nilai yang dihapus.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
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:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Value

Menghapus nilai yang ditentukan dari tag yang telah ditentukan sebelumnya, tetapi tidak menghapus tag.

Jenis:String[]
Position:1
Nilai default:None
Diperlukan:False
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

String[]

SwitchParameter

Output

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource