Baca dalam bahasa Inggris

Bagikan melalui

New-AzResource

  • Referensi
Modul:
Az.Resources

Membuat sumber daya.

Sintaks

New-AzResource
   [-Location <String>]
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-IsFullObject]
   [-AsJob]
   -ResourceId <String>
   [-ODataQuery <String>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResource
   [-Location <String>]
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-IsFullObject]
   [-AsJob]
   -ResourceName <String>
   -ResourceType <String>
   [-ExtensionResourceName <String>]
   [-ExtensionResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzResource
   [-Location <String>]
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-IsFullObject]
   [-AsJob]
   -ResourceName <String>
   -ResourceType <String>
   [-ExtensionResourceName <String>]
   [-ExtensionResourceType <String>]
   [-ODataQuery <String>]
   [-TenantLevel]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzResource membuat sumber daya Azure, seperti situs web, server Azure SQL Database, atau Azure SQL Database, dalam grup sumber daya.

Contoh

Contoh 1: Membuat sumber daya

New-AzResource -Location "West US" -Properties @{test="test"} -ResourceName TestSite06 -ResourceType microsoft.web/sites -ResourceGroupName ResourceGroup11 -Force

Perintah ini membuat sumber daya yang merupakan situs web di ResourceGroup11.

Contoh 2: Membuat sumber daya menggunakan splatting

$prop = @{
    Location          = "West US"
    Properties        = @{test = "test"}
    ResourceName      = "TestSite06"
    ResourceType      = "microsoft.web/sites"
    ResourceGroupName = "ResourceGroup11"
    Force             = $true
}

New-AzResource @prop

Perintah ini membuat sumber daya yang merupakan situs web di ResourceGroup11.

Parameter

-ApiVersion

Menentukan versi API penyedia sumber daya yang akan digunakan. Jika Anda tidak menentukan versi, cmdlet ini menggunakan versi terbaru yang tersedia.

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

-AsJob

Jalankan cmdlet di latar belakang

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

-Confirm

Meminta konfirmasi 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

-ExtensionResourceName

Menentukan nama sumber daya ekstensi untuk sumber daya. Misalnya, untuk menentukan database, gunakan format berikut: nama server/nama database

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

-ExtensionResourceType

Menentukan jenis sumber daya untuk sumber daya ekstensi. Misalnya, jika sumber daya ekstensi adalah database, tentukan jenis berikut: Microsoft.Sql/Servers/Databases

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
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

-IsFullObject

Menunjukkan bahwa objek yang ditentukan parameter Properti adalah objek lengkap.

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

-Kind

Menentukan jenis sumber daya untuk sumber daya.

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

-Location

Menentukan lokasi sumber daya. Tentukan lokasi pusat data, seperti AS Tengah atau Asia Tenggara. Anda dapat menempatkan sumber daya di lokasi mana pun yang mendukung sumber daya jenis tersebut. Grup sumber daya dapat berisi sumber daya dari lokasi yang berbeda. Untuk menentukan lokasi mana yang mendukung setiap jenis sumber daya, gunakan cmdlet Get-AzLocation.

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

-ODataQuery

Menentukan filter gaya Open Data Protocol (OData). Cmdlet ini menambahkan nilai ini ke permintaan selain filter lain.

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

-Plan

Tabel hash yang mewakili properti rencana sumber daya.

Jenis:Hashtable
Alias:PlanObject
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
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

-Properties

Menentukan properti sumber daya untuk sumber daya. Gunakan parameter ini untuk menentukan nilai properti yang khusus untuk jenis sumber daya.

Jenis:PSObject
Alias:PropertyObject
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ResourceGroupName

Menentukan nama grup sumber daya tempat cmdlet ini membuat sumber daya.

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

-ResourceId

Menentukan ID sumber daya yang sepenuhnya memenuhi syarat, termasuk langganan, seperti dalam contoh berikut: /subscriptions/ID langganan/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

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

-ResourceName

Menentukan nama sumber daya. Misalnya, untuk menentukan database, gunakan format berikut: ContosoServer/ContosoDatabase

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

-ResourceType

Menentukan jenis sumber daya. Misalnya, untuk database, jenis sumber dayanya adalah sebagai berikut: Microsoft.Sql/Servers/Databases

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

-Sku

Tabel hash yang mewakili properti sku.

Jenis:Hashtable
Alias:SkuObject
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Tag

Pasangan kunci-nilai dalam bentuk tabel hash. Misalnya: @{key0="value0"; key1=$null; key2="value2"}

Jenis:Hashtable
Alias:Tags
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-TenantLevel

Menunjukkan bahwa cmdlet ini beroperasi di tingkat penyewa.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
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

Output