Bagikan melalui

New-AzTag

  • Referensi
Modul:
Az.Resources

Membuat tag Azure yang telah ditentukan sebelumnya atau menambahkan nilai ke tag yang sudah ada | Membuat atau memperbarui seluruh kumpulan tag pada sumber daya atau langganan.

Sintaks

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

Deskripsi

CreatePredefinedTagSet: Cmdlet New-AzTag membuat tag Azure yang telah ditentukan sebelumnya dengan nilai opsional yang telah ditentukan sebelumnya. Anda juga dapat menggunakannya untuk menambahkan nilai tambahan ke tag yang sudah ditentukan sebelumnya. Untuk membuat tag yang telah ditentukan sebelumnya, masukkan nama tag unik. Untuk menambahkan nilai ke tag yang sudah ditentukan sebelumnya, tentukan nama tag yang ada dan nilai baru. Cmdlet ini mengembalikan objek yang mewakili tag baru atau yang dimodifikasi dengan nilainya dan jumlah sumber daya yang telah diterapkannya. Modul Tag Azure yang merupakan bagian dari New-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. Untuk menerapkan tag yang telah ditentukan sebelumnya ke grup sumber daya atau sumber daya, gunakan parameter Tag cmdlet New-AzTag. Untuk mencari grup sumber daya dengan nama atau nama dan nilai tag tertentu, gunakan parameter Tag cmdlet Get-AzResourceGroup. Setiap tag memiliki nama. Nilai bersifat opsional. Tag Azure yang telah ditentukan sebelumnya dapat memiliki beberapa nilai, tetapi saat Anda menerapkan tag ke sumber daya atau grup sumber daya, Anda menerapkan nama tag dan hanya salah satu nilainya. Misalnya, Anda dapat membuat tag Departemen yang telah ditentukan sebelumnya dengan nilai untuk setiap departemen, seperti Keuangan, Sumber Daya Manusia, dan IT. Saat Anda menerapkan tag Departemen ke sumber daya, Anda hanya menerapkan satu nilai yang telah ditentukan sebelumnya, seperti Keuangan.

CreateByResourceIdParameterSet: Cmdlet New-AzTag dengan ResourceId membuat atau memperbarui seluruh kumpulan tag pada sumber daya atau langganan. Operasi ini memungkinkan penambahan atau mengganti seluruh kumpulan tag pada sumber daya atau langganan yang ditentukan. Entitas yang ditentukan dapat memiliki maksimum 50 tag.

Contoh

Contoh 1: Membuat tag yang telah ditentukan sebelumnya

New-AzTag -Name "FY2015"

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

Perintah ini membuat tag yang telah ditentukan sebelumnya bernama FY2015. Tag ini tidak memiliki nilai. Anda dapat menerapkan tag tanpa nilai ke sumber daya atau grup sumber daya, atau menggunakan New-AzTag untuk menambahkan nilai ke tag. Anda juga dapat menentukan nilai saat menerapkan tag ke sumber daya atau grup sumber daya.

Contoh 2: Membuat tag yang telah ditentukan sebelumnya dengan nilai

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

Name:   Department
Count:  0
Values: 

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

Perintah ini membuat tag yang telah ditentukan sebelumnya bernama Departemen dengan nilai Keuangan.

Contoh 3: Menambahkan nilai ke tag yang telah ditentukan sebelumnya

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

Perintah ini membuat tag yang telah ditentukan sebelumnya bernama Departemen dengan dua nilai. Jika nama tag ada, New-AzTag menambahkan nilai ke tag yang ada alih-alih membuat yang baru.

Contoh 4: Gunakan tag yang telah ditentukan sebelumnya

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

Perintah dalam contoh ini membuat dan menggunakan tag yang telah ditentukan sebelumnya.

Contoh 5: Membuat atau memperbarui seluruh kumpulan tag pada langganan

$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

Perintah ini membuat atau memperbarui seluruh kumpulan tag pada langganan dengan {subId}.

Contoh 6: Membuat atau memperbarui seluruh kumpulan tag pada sumber daya

$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

Perintah ini membuat atau memperbarui seluruh kumpulan tag pada sumber daya dengan {resourceId}.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Name

Menentukan nama tag yang telah ditentukan sebelumnya. Untuk membuat tag baru yang telah ditentukan sebelumnya, masukkan nama unik. Untuk menambahkan nilai ke tag yang sudah ada, masukkan nama tag yang ada. Jika tag yang sudah ditentukan sebelumnya memiliki nama yang ditentukan, New-AzTag menambahkan nilai yang ditentukan, jika ada, ke tag dengan nama tersebut alih-alih membuat tag baru.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ResourceId

Pengidentifikasi sumber daya untuk entitas yang ditandai. Sumber daya, grup sumber daya, atau langganan mungkin ditandai.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Tag

Tag yang akan diletakkan pada sumber daya.

Jenis:Hashtable
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Value

Menentukan nilai tag yang telah ditentukan sebelumnya. Tag yang telah ditentukan sebelumnya dapat memiliki beberapa nilai, tetapi Anda hanya dapat memasukkan satu nilai di setiap perintah. Parameter ini bersifat opsional, karena tag dapat memiliki nama tanpa nilai.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

Hashtable

Output

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