New-AzTag

  • Başvuru
Modül:
Az.Resources

Önceden tanımlanmış bir Azure etiketi oluşturur veya mevcut bir etikete değer ekler | Bir kaynakta veya abonelikte etiket kümesinin tamamını oluşturur veya güncelleştirir.

Syntax

New-AzTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzTag
   [-ResourceId] <String>
   [-Tag] <Hashtable>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

CreatePredefinedTagSet: New-AzTag cmdlet'i, isteğe bağlı olarak önceden tanımlanmış bir değerle önceden tanımlanmış bir Azure etiketi oluşturur. Ayrıca, önceden tanımlanmış mevcut etiketlere ek değerler eklemek için de kullanabilirsiniz. Önceden tanımlanmış bir etiket oluşturmak için benzersiz bir etiket adı girin. Önceden tanımlanmış mevcut bir etikete değer eklemek için mevcut etiketin adını ve yeni değeri belirtin. Bu cmdlet, değerleri ve uygulandığı kaynak sayısıyla yeni veya değiştirilmiş etiketi temsil eden bir nesne döndürür. New-AzTag'in 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. Bir kaynağa veya kaynak grubuna önceden tanımlanmış bir etiket uygulamak için New-AzTag cmdlet'inin Tag parametresini kullanın. Belirtilen etiket adı veya adı ve değeri olan kaynak gruplarını aramak için Get-AzResourceGroup cmdlet'inin Tag parametresini kullanın. Her etiketin bir adı vardır. Değerler isteğe bağlıdır. Önceden tanımlanmış bir Azure etiketinin birden çok değeri olabilir, ancak etiketi bir kaynağa veya kaynak grubuna uyguladığınızda etiket adını ve yalnızca bir değerini uygularsınız. Örneğin, her departman için Finans, İnsan Kaynakları ve BT gibi bir değerle önceden tanımlanmış bir Departman etiketi oluşturabilirsiniz. Bir kaynağa Department etiketini uyguladığınızda, Finans gibi önceden tanımlanmış tek bir değer uygularsınız.

CreateByResourceIdParameterSet: ResourceId içeren New-AzTag cmdlet'i bir kaynak veya abonelikte tüm etiket kümesini oluşturur veya güncelleştirir. Bu işlem, belirtilen kaynak veya abonelikte tüm etiket kümesinin eklenmesine veya değiştirilmesine olanak tanır. Belirtilen varlığın en fazla 50 etiketi olabilir.

Örnekler

Örnek 1: Önceden tanımlanmış etiket oluşturma

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             0     {}

Bu komut, FY2015 adlı önceden tanımlanmış bir etiket oluşturur. Bu etiketin değeri yok. Bir kaynağa veya kaynak grubuna değer içermeyen bir etiket uygulayabilir veya etikete değer eklemek için New-AzTag kullanabilirsiniz. Etiketi kaynağa veya kaynak grubuna uyguladığınızda da bir değer belirtebilirsiniz.

Örnek 2: Bir değerle önceden tanımlanmış etiket oluşturma

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 

        Name        Count
        =========   =====
        Finance     0

Bu komut, Finance değerine sahip Department adlı önceden tanımlanmış bir etiket oluşturur.

Örnek 3: Önceden tanımlanmış etikete değer ekleme

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
New-AzTag -Name "Department" -Value "IT"
Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0
        IT          0

Bu komutlar, iki değere sahip Department adlı önceden tanımlanmış bir etiket oluşturur. Etiket adı varsa, New-AzTag değeri yeni bir etiket oluşturmak yerine mevcut etikete ekler.

Örnek 4: Önceden tanımlanmış etiket kullanma

New-AzTag -Name "CostCenter" -Value "0001"

Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 

Set-AzResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}

Name:      EngineerBlog
Location:  East US
Resources: 
            
  Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US
    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001 

Get-AzTag -Name "CostCenter"

Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 

Get-AzResourceGroup -Tag @{Name="CostCenter"}

Name:      EngineerBlog
Location:  East US
Resources: 
     Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US

    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001

Bu örnekteki komutlar önceden tanımlanmış bir etiket oluşturur ve kullanır.

Örnek 5: Abonelikte tüm etiket kümesini oluşturur veya güncelleştirir

$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags

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

Bu komut abonelikte tüm etiket kümesini {subId} ile oluşturur veya güncelleştirir.

Örnek 6: Bir kaynakta tüm etiket kümesini oluşturur veya güncelleştirir

$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags

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

Bu komut, kaynak üzerindeki etiket kümesinin tamamını {resourceId} ile oluşturur veya güncelleştirir.

Parametreler

-Confirm

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Önceden tanımlanmış etiket adını belirtir. Önceden tanımlanmış yeni bir etiket oluşturmak için benzersiz bir ad girin. Var olan bir etikete değer eklemek için mevcut etiketin adını girin. Önceden tanımlanmış mevcut bir etiket belirtilen ada sahipse, New-AzTag yeni bir etiket oluşturmak yerine belirtilen değeri (varsa) bu ada sahip etikete ekler.

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

-ResourceId

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

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

-Tag

Kaynağa konulacak etiketler.

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Value

Önceden tanımlanmış bir etiket değeri belirtir. Önceden tanımlanmış etiketlerin birden çok değeri olabilir, ancak her komuta yalnızca bir değer girebilirsiniz. Etiketlerin değerleri olmayan adları olabileceği için bu parametre isteğe bağlıdır.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

Hashtable

Çıkışlar

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