Remove-AzureRmTag

  • Referensi
Modul:
AzureRM.Tags

Menghapus tag atau nilai Azure yang telah ditentukan sebelumnya.

Penting

Karena modul Az PowerShell sekarang memiliki semua kemampuan modul AzureRM PowerShell dan lebih banyak lagi, kami akan menghentikan modul AzureRM PowerShell pada 29 Februari 2024.

Untuk menghindari gangguan layanan, perbarui skrip Anda yang menggunakan modul AzureRM PowerShell untuk menggunakan modul Az PowerShell paling lambat 29 Februari 2024. Untuk memperbarui skrip Anda secara otomatis, ikuti panduan memulai cepat.

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 sumber daya atau grup sumber daya. Sebelum menggunakan Remove-AzureRmTag, gunakan parameter Tag cmdlet Set-AzureRMResourceGroup untuk menghapus tag atau nilai dari sumber daya atau grup 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 nilai nama yang dapat Anda gunakan untuk mengategorikan sumber daya dan grup sumber daya Azure Anda, seperti menurut 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 sebelumnya memungkinkan Anda menetapkan nama dan nilai standar, konsisten, dan dapat diprediksi untuk tag di 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.

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

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
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 .

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

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Value

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

Type:String[]
Position:1
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Input

String

String[]

SwitchParameter

Output

PSTag