Bagikan melalui

Remove-AzureRmTag

  • Referensi
Modul:
AzureRM.Tags

Menghapus tag atau nilai Azure yang telah ditentukan sebelumnya.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

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

Deskripsi

Cmdlet Remove-AzureRmTag 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-AzureRmTag 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-AzureRmTag, gunakan parameter Tag cmdlet Set-AzureRMResourceGroup untuk menghapus tag atau nilai dari grup sumber daya atau sumber daya. Modul Tag Azure yang merupakan bagian dari Remove-AzureRmTag 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.

Contoh

Contoh 1: Menghapus tag yang telah ditentukan sebelumnya

PS C:\>Remove-AzureRmTag -Name "Department"

Perintah ini menghapus tag yang telah ditentukan sebelumnya bernama Departemen dan semua sumber dayanya. 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

PS C:\>Remove-AzureRmTag -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.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Aliases:cf
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama tag yang akan dihapus. Secara default, Remove-AzureRmTag 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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Jenis:SwitchParameter
Aliases:wi
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

String[]

SwitchParameter

Output

PSTag