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.

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-ResourceId

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

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

-Tag

Tag yang akan diletakkan pada sumber daya.

Type:	Hashtable
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-WhatIf

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

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

Input

String

Hashtable

Output

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

New-AzTag

Sintaks

Deskripsi

Contoh

Contoh 1: Membuat tag yang telah ditentukan sebelumnya

Contoh 2: Membuat tag yang telah ditentukan sebelumnya dengan nilai

Contoh 3: Menambahkan nilai ke tag yang telah ditentukan sebelumnya

Contoh 4: Gunakan tag yang telah ditentukan sebelumnya

Contoh 5: Membuat atau memperbarui seluruh kumpulan tag pada langganan

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

Parameter

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Input

Output

Saran dan Komentar

Sumber Daya Tambahan:

New-AzTag

Sintaks

Deskripsi

Contoh

Contoh 1: Membuat tag yang telah ditentukan sebelumnya

Contoh 2: Membuat tag yang telah ditentukan sebelumnya dengan nilai

Contoh 3: Menambahkan nilai ke tag yang telah ditentukan sebelumnya

Contoh 4: Gunakan tag yang telah ditentukan sebelumnya

Contoh 5: Membuat atau memperbarui seluruh kumpulan tag pada langganan

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

Parameter

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Input

Output

Link Terkait

Saran dan Komentar

Sumber Daya Tambahan: