New-AzResourceGroup
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 |