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.

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

-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 .

Type:String
Position:0
Default value:None
Required: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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:Named
Default value:None
Required:True
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
Required:False
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

String[]

SwitchParameter

Output

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