Bagikan melalui

New-AzureRmTag

  • Referensi
Modul:
AzureRM.Tags

Membuat tag Azure yang telah ditentukan sebelumnya atau menambahkan nilai ke tag yang sudah ada.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

New-AzureRmTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzureRmTag 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-AzureRmTag 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-AzureRmTag. Untuk mencari grup sumber daya dengan nama atau nama dan nilai tag tertentu, gunakan parameter Tag cmdlet Get-AzureRMResourceGroup. 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.

Contoh

Contoh 1: Membuat tag yang telah ditentukan sebelumnya

PS C:\>New-AzureRmTag -Name "FY2015"
Name:   FY2015
Count:  0
Values: 

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

        Finance     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-AzureRmTag 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

PS C:\>New-AzureRmTag -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

PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
PS C:\>New-AzureRmTag -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-AzureRmTag menambahkan nilai ke tag yang sudah ada alih-alih membuat yang baru.

Contoh 4: Gunakan tag yang telah ditentukan sebelumnya

PS C:\>New-AzureRmTag -Name "CostCenter" -Value "0001"
Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 
PS C:\>Set-AzureRmResourceGroup -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 
PS C:\>Get-AzureRmTag -Name "CostCenter"
Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 
PS C:\>Get-AzureRmResourceGroup -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.

Parameter

-DefaultProfile

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

Jenis:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama tag. 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-AzureRmTag 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
Accept pipeline input:True
Accept wildcard characters:False

-Value

Menentukan nilai tag. 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
Accept pipeline input:True
Accept wildcard characters:False

Input

String

Output

PSTag