Bagikan melalui

New-AzResourceGroup

  • Referensi
Modul:
Az.Resources

Membuat grup sumber daya Azure.

Sintaks

New-AzResourceGroup
   [-Name] <String>
   [-Location] <String>
   [-Tag <Hashtable>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzResourceGroup membuat grup sumber daya Azure. Anda dapat membuat grup sumber daya hanya dengan menggunakan nama dan lokasi, lalu menggunakan cmdlet New-AzResource untuk membuat sumber daya untuk ditambahkan ke grup sumber daya. Untuk menambahkan penyebaran ke grup sumber daya yang ada, gunakan cmdlet New-AzResourceGroupDeployment. Untuk menambahkan sumber daya ke grup sumber daya yang sudah ada, gunakan cmdlet New-AzResource . Sumber daya Azure adalah entitas Azure yang dikelola pengguna, seperti server database, database, atau situs web. Grup sumber daya Azure adalah kumpulan sumber daya Azure yang disebarkan sebagai unit.

Contoh

Contoh 1: Membuat grup sumber daya kosong

New-AzResourceGroup -Name RG01 -Location "South Central US"

Perintah ini membuat grup sumber daya yang tidak memiliki sumber daya. Anda dapat menggunakan cmdlet New-AzResource atau New-AzResourceGroupDeployment untuk menambahkan sumber daya dan penyebaran ke grup sumber daya ini.

Contoh 2: Membuat grup sumber daya kosong menggunakan parameter posisional

New-AzResourceGroup RG01 "South Central US"

Perintah ini membuat grup sumber daya yang tidak memiliki sumber daya.

Contoh 3: Membuat grup sumber daya dengan tag

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

Perintah ini membuat grup sumber daya kosong. Perintah ini sama dengan perintah di Contoh 1, kecuali bahwa perintah menetapkan tag ke grup sumber daya. Tag pertama, bernama Kosong, dapat digunakan untuk mengidentifikasi grup sumber daya yang tidak memiliki sumber daya. Tag kedua diberi nama Departemen dan memiliki nilai Pemasaran. Anda dapat menggunakan tag seperti ini untuk mengategorikan grup sumber daya untuk administrasi atau anggaran.

Parameter

-ApiVersion

Menentukan versi API yang didukung oleh Penyedia sumber daya. Anda dapat menentukan versi yang berbeda dari versi default.

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

-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

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

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

-Location

Menentukan lokasi grup sumber daya. Tentukan lokasi pusat data Azure, seperti US Barat atau Asia Tenggara. Anda dapat menempatkan grup sumber daya di lokasi mana pun. Grup sumber daya tidak harus berada di lokasi yang sama dengan langganan Azure Anda atau di lokasi yang sama dengan sumber dayanya. Untuk menentukan lokasi mana yang mendukung setiap jenis sumber daya, gunakan cmdlet Get-AzResourceProvider dengan parameter ProviderNamespace .

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

-Name

Menentukan nama untuk grup sumber daya. Nama sumber daya harus unik dalam langganan. Jika grup sumber daya yang memiliki nama tersebut sudah ada, perintah akan meminta konfirmasi sebelum mengganti grup sumber daya yang ada.

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

-Pre

Menunjukkan bahwa cmdlet ini mempertimbangkan versi API pra-rilis ketika secara otomatis menentukan versi mana yang akan digunakan.

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

-Tag

Pasangan kunci-nilai dalam bentuk tabel hash. Misalnya: @{key0="value0"; key1=$null; key2="value2"} Untuk menambahkan atau mengubah tag, Anda harus mengganti kumpulan tag untuk grup sumber daya. Setelah menetapkan tag ke sumber daya dan grup, Anda dapat menggunakan parameter Tag Get-AzResource dan Get-AzResourceGroup untuk mencari sumber daya dan grup menurut nama tag atau berdasarkan nama dan nilai. Anda dapat menggunakan tag untuk mengategorikan sumber daya Anda, seperti berdasarkan departemen atau pusat biaya, atau untuk melacak catatan atau komentar tentang sumber daya. Untuk mendapatkan tag yang telah ditentukan sebelumnya, gunakan cmdlet Get-AzTag.

Jenis:Hashtable
Alias:Tags
Position:Named
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

PSResourceGroup