Aracılığıyla paylaş

Get-AzTag

  • Başvuru
Modül:
Az.Resources

Önceden tanımlanmış Azure etiketlerini alır | Bir kaynak veya abonelik üzerindeki etiket kümesinin tamamını alır.

Sözdizimi

Get-AzTag
   [[-Name] <String>]
   [-Detailed]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzTag
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

GetPredefinedTagSet: Get-AzTag cmdlet'i aboneliğinizde önceden tanımlanmış Azure etiketlerini alır. Bu cmdlet, etiketlerle ilgili temel bilgileri veya etiketler ve bunların değerleri hakkında ayrıntılı bilgileri döndürür. Tüm çıkış nesneleri, etiketlerin ve değerlerin uygulandığı kaynak ve kaynak gruplarının sayısını temsil eden bir Count özelliği içerir. Get-AzTag'in bir parçası olduğu Azure Etiketleri modülü, önceden tanımlanmış Azure etiketlerini 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. Önceden tanımlanmış bir etiket oluşturmak için New-AzTag cmdlet'ini kullanın. Bir kaynak grubuna önceden tanımlanmış etiket uygulamak için New-AzTag cmdlet'inin Tag parametresini kullanın. Kaynak gruplarında belirli bir etiket adı veya adı ve değeri aramak için Get-AzResourceGroup cmdlet'inin Tag parametresini kullanın.

GetByResourceIdParameterSet: ResourceId içeren Get-AzTag cmdlet'i bir kaynak veya abonelik üzerindeki tüm etiket kümesini alır.

Örnekler

Örnek 1: Önceden tanımlanmış tüm etiketleri alma

Get-AzTag

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

Department    5
FY2015        2
CostCenter   20

Bu komut abonelikteki önceden tanımlanmış tüm etiketleri alır. Count özelliği, etiketin abonelikteki kaynaklara ve kaynak gruplarına kaç kez uygulandığını gösterir.

Örnek 2: Ada göre etiket alma

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

Bu komut Department etiketi ve değerleri hakkında ayrıntılı bilgi alır. Count özelliği, etiketin ve değerlerinin abonelikteki kaynaklara ve kaynak gruplarına kaç kez uygulandığını gösterir.

Örnek 3: Tüm etiketlerin değerlerini alma

Get-AzTag -Detailed

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3


Name:   FY2015
Count:  2


Name:   CostCenter
Count:  20
Values: 

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

        0001          5
        0002         10
        0003          5

Bu komut, abonelikte önceden tanımlanmış tüm etiketler hakkında ayrıntılı bilgi almak için Detailed parametresini kullanır. Detailed parametresinin kullanılması, her etiket için Name parametresinin kullanılmasıyla eşdeğerdir.

Örnek 4: Abonelikte tüm etiket kümesini alma

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

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

Bu komut, {subId} aboneliğindeki tüm etiket kümesini alır.

Örnek 5: Bir kaynakta etiket kümesinin tamamını alma

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Bu komut, {resourceId} ile kaynak üzerindeki etiket kümesinin tamamını alır.

Parametreler

-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

-Detailed

Bu işlemin çıkışa etiket değerleri hakkında bilgi eklediğini gösterir.

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

-Name

Önceden tanımlanmış etiketin adı. Get-AzTag varsayılan olarak abonelikteki tüm önceden tanımlanmış etiketler hakkında temel bilgileri alır. Name parametresini belirttiğinizde, Detailed parametresinin hiçbir etkisi olmaz.

Tür:String
Position:0
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

Girişler

String

SwitchParameter

Çıkışlar

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