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-AzTag kullanmadan önce, kaynak veya kaynak grubundan etiketi veya değerleri silmek için Set-AzResourceGroup cmdlet'in Tag parametresini kullanın. Remove-AzTag'in parçası olduğu 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: ResourceId içeren Remove-AzTag cmdlet'i bir kaynak veya abonelik üzerindeki tüm etiket kümesini 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ıyorsa 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