Aracılığıyla paylaş

Remove-AzTag

  • Başvuru
Modül:
Az.Resources

Önceden tanımlanmış Azure etiketlerini veya değerlerini siler | Bir kaynak veya abonelik üzerindeki etiket kümesinin tamamını siler.

Sözdizimi

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

Description

RemovePredefinedTagSet: Remove-AzTag cmdlet'i önceden tanımlanmış Azure etiketlerini ve değerlerini aboneliğinizden siler. Önceden tanımlanmış bir etiketten belirli değerleri silmek için Value parametresini kullanın. Varsayılan olarak Remove-AzTag belirtilen etiketi ve tüm değerlerini siler. Şu anda bir kaynağa veya kaynak grubuna uygulanmış olan bir etiketi veya değeri silemezsiniz. remove-azTagkullanmadan önce, etiket veya değerleri kaynak veya kaynak grubundan silmek için Set-AzResourceGroup cmdlet'in Tag parametresini kullanın. Remove-AzTag Azure Etiketleri modülü, önceden tanımlanmış Azure etiketlerinizi yönetmenize yardımcı olabilir. Azure etiketi, Departman veya maliyet merkezi gibi Azure kaynaklarınızı ve kaynak gruplarınızı kategorilere ayırmak ya da kaynaklar ve gruplar hakkındaki notları veya açıklamaları izlemek için kullanabileceğiniz bir ad-değer çiftidir. Etiketleri tek bir adımda tanımlayabilir ve uygulayabilirsiniz, ancak önceden tanımlanmış etiketler, aboneliğinizdeki etiketler için standart, tutarlı, öngörülebilir adlar ve değerler oluşturmanıza olanak sağlar.

RemoveByResourceIdParameterSet: ResourceIdRemove-AzTag cmdlet'i bir kaynak veya abonelik üzerindeki etiket kümesinin tamamını siler.

Örnekler

Örnek 1: Önceden tanımlanmış etiketi silme

Remove-AzTag -Name "Department"

Bu komut, Department adlı önceden tanımlanmış etiketi ve tüm değerlerini siler. Etiket herhangi bir kaynağa veya kaynak grubuna uygulanmışsa, komut başarısız olur.

Örnek 2: Önceden tanımlanmış bir etiketten değer silme

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

Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

Bu komut, önceden tanımlanmış Department etiketinden HumanResources değerini siler. Etiketi silmez. Değer herhangi bir kaynağa veya kaynak grubuna uygulanmışsa, komut başarısız olur.

Örnek 3: Abonelikte tüm etiket kümesini siler

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

Bu komut, {subId} aboneliğindeki etiket kümesinin tamamını siler. "-PassThru" geçirilmediğinde silinen nesneyi döndürmez.

Örnek 4: Bir kaynak üzerindeki etiket kümesinin tamamını siler

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

Bu komut, {resourceId} ile kaynak üzerindeki etiket kümesinin tamamını siler. "-PassThru" geçirirken silinen oject değerini döndürür.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Kaldırılacak önceden tanımlanmış etiketin Adını belirtir. Varsayılan olarak Remove-AzTag belirtilen etiketi ve tüm değerlerini kaldırır. Seçili değerleri silmek, ancak etiketi silmek için Value parametresini kullanın.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PassThru

Silinen etiketi veya silinen değerli sonuç etiketini temsil eden bir nesne döndürür.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceId

Etiketli varlığın kaynak tanımlayıcısı. Bir kaynak, kaynak grubu veya abonelik etiketlenebilir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Value

Belirtilen değerleri önceden tanımlanmış etiketten siler, ancak etiketi silmez.

Tür:String[]
Position:1
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

String[]

SwitchParameter

Çıkışlar

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