Bagikan melalui

New-AzureRmApplicationGateway

  • Referensi
Modul:
AzureRM.Network

Membuat gateway aplikasi.

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-AzureRmApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration]>
   [-SslCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate]>]
   [-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
   [-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
   [-FrontendIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration]>]
   -FrontendPorts <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort]>
   [-Probes <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe]>]
   -BackendAddressPools <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>
   -BackendHttpSettingsCollection <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings]>
   -HttpListeners <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener]>
   [-UrlPathMaps <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap]>]
   -RequestRoutingRules <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule]>
   [-RedirectConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzureRmApplicationGateway membuat gateway aplikasi Azure. Gateway aplikasi memerlukan hal berikut:

  • Grup sumber daya.
  • Jaringan virtual.
  • Kumpulan server back-end, yang berisi alamat IP server back-end.
  • Pengaturan kumpulan server back-end. Setiap kumpulan memiliki pengaturan seperti port, protokol, dan afinitas berbasis cookie, yang diterapkan ke semua server dalam kumpulan.
  • Alamat IP front-end, yang merupakan alamat IP yang dibuka di gateway aplikasi. Alamat IP front-end dapat berupa alamat IP publik atau alamat IP internal.
  • Port front-end, yang merupakan port publik yang dibuka di gateway aplikasi. Lalu lintas yang mengenai port ini dialihkan ke server back-end.
  • Aturan perutean permintaan yang mengikat pendengar dan kumpulan server back-end. Aturan mendefinisikan kumpulan server back-end mana yang harus diarahkan ke lalu lintas ketika mencapai pendengar tertentu. Pendengar memiliki port front-end, alamat IP front-end, protokol (HTTP atau HTTPS) dan nama sertifikat Secure Sockets Layer (SSL) (jika mengonfigurasi offload SSL).

Contoh

Contoh 1: Membuat gateway aplikasi

PS C:\> $ResourceGroup = New-AzureRmResourceGroup -Name "ResourceGroup01" -Location "West US" -Tag @{Name = "Department"; Value = "Marketing"} 
PS C:\> $Subnet = New-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -AddressPrefix 10.0.0.0/24
PS C:\> $VNet = New-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01" -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $Subnet
PS C:\> $VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name $Subnet01 -VirtualNetwork $VNet 
PS C:\> $GatewayIPconfig = New-AzureRmApplicationGatewayIPConfiguration -Name "GatewayIp01" -Subnet $Subnet
PS C:\> $Pool = New-AzureRmApplicationGatewayBackendAddressPool -Name "Pool01" -BackendIPAddresses 10.10.10.1, 10.10.10.2, 10.10.10.3
PS C:\> $PoolSetting = New-AzureRmApplicationGatewayBackendHttpSettings -Name "PoolSetting01"  -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $FrontEndPort = New-AzureRmApplicationGatewayFrontendPort -Name "FrontEndPort01"  -Port 80
# Create a public IP address
PS C:\> $PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIpName01" -Location "West US" -AllocationMethod "Dynamic"
PS C:\> $FrontEndIpConfig = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndConfig01" -PublicIPAddress $PublicIp
PS C:\> $Listener = New-AzureRmApplicationGatewayHttpListener -Name "ListenerName01"  -Protocol "Http" -FrontendIpConfiguration $FrontEndIpConfig -FrontendPort $FrontEndPort
PS C:\> $Rule = New-AzureRmApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType basic -BackendHttpSettings $PoolSetting -HttpListener $Listener -BackendAddressPool $Pool
PS C:\> $Sku = New-AzureRmApplicationGatewaySku -Name "Standard_Small" -Tier Standard -Capacity 2
PS C:\> $Gateway = New-AzureRmApplicationGateway -Name "AppGateway01" -ResourceGroupName "ResourceGroup01" -Location "West US" -BackendAddressPools $Pool -BackendHttpSettingsCollection $PoolSetting -FrontendIpConfigurations $FrontEndIpConfig  -GatewayIpConfigurations $GatewayIpConfig -FrontendPorts $FrontEndPort -HttpListeners $Listener -RequestRoutingRules $Rule -Sku $Sku

Contoh berikut membuat gateway aplikasi dengan terlebih dahulu membuat grup sumber daya dan jaringan virtual, serta yang berikut ini:

  • Kumpulan server back-end
  • Pengaturan kumpulan server back-end
  • Port ujung depan
  • Alamat IP front-end
  • Aturan perutean permintaan Keempat perintah ini membuat jaringan virtual. Perintah pertama membuat konfigurasi subnet. Perintah kedua membuat jaringan virtual. Perintah ketiga memverifikasi konfigurasi subnet dan perintah keempat memverifikasi bahwa jaringan virtual berhasil dibuat. Perintah berikut membuat gateway aplikasi. Perintah pertama membuat konfigurasi IP bernama GatewayIp01 untuk subnet yang dibuat sebelumnya. Perintah kedua membuat kumpulan server back-end bernama Pool01 dengan daftar alamat IP back-end dan menyimpan kumpulan dalam variabel $Pool. Perintah ketiga membuat pengaturan untuk kumpulan server back-end dan menyimpan pengaturan dalam variabel $PoolSetting. Perintah forth membuat port front-end pada port 80, menamainya FrontEndPort01, dan menyimpan port dalam variabel $FrontEndPort. Perintah kelima membuat alamat IP publik dengan menggunakan New-AzureRmPublicIpAddress. Perintah keenam membuat konfigurasi IP front-end menggunakan $PublicIp, menamainya FrontEndPortConfig01, dan menyimpannya dalam variabel $FrontEndIpConfig. Perintah ketujuh membuat listener menggunakan $FrontEndIpConfig $FrontEndPort yang dibuat sebelumnya. Perintah kedelapan membuat aturan untuk pendengar. Perintah kesembilan menetapkan SKU. Perintah kesepuluh membuat gateway menggunakan objek yang diatur oleh perintah sebelumnya.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

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

-AuthenticationCertificates

Menentukan sertifikat autentikasi untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayAuthenticationCertificate]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-AutoscaleConfiguration

Konfigurasi Skala Otomatis

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

-BackendAddressPools

Menentukan daftar kumpulan alamat back-end untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-BackendHttpSettingsCollection

Menentukan daftar pengaturan HTTP back-end untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayBackendHttpSettings]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
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:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-EnableFIPS

Apakah FIPS diaktifkan.

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

-EnableHttp2

Apakah HTTP2 diaktifkan.

Jenis:SwitchParameter
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

-FrontendIPConfigurations

Menentukan daftar konfigurasi IP front-end untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayFrontendIPConfiguration]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-FrontendPorts

Menentukan daftar port front-end untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayFrontendPort]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-GatewayIPConfigurations

Menentukan daftar konfigurasi IP untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayIPConfiguration]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-HttpListeners

Menentukan daftar listener HTTP untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayHttpListener]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Location

Menentukan wilayah tempat membuat gateway aplikasi.

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

-Name

Menentukan nama gateway aplikasi.

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

-Probes

Menentukan pemeriksaan untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayProbe]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-RedirectConfigurations

Daftar konfigurasi pengalihan

Jenis:List<T>[PSApplicationGatewayRedirectConfiguration]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-RequestRoutingRules

Menentukan daftar aturan perutean permintaan untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayRequestRoutingRule]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ResourceGroupName

Menentukan nama grup sumber daya untuk membuat gateway aplikasi.

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

-Sku

Menentukan unit penyimpanan stok (SKU) gateway aplikasi.

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

-SslCertificates

Menentukan daftar sertifikat Secure Sockets Layer (SSL) untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewaySslCertificate]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-SslPolicy

Menentukan kebijakan SSL untuk gateway aplikasi.

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

-TrustedRootCertificate

Daftar sertifikat akar tepercaya

Jenis:List<T>[PSApplicationGatewayTrustedRootCertificate]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-UrlPathMaps

Menentukan peta jalur URL untuk gateway aplikasi.

Jenis:List<T>[PSApplicationGatewayUrlPathMap]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-WebApplicationFirewallConfiguration

Menentukan konfigurasi firewall aplikasi web (WAF). Anda dapat menggunakan cmdlet Get-AzureRmApplicationGatewayWebApplicationFirewallConfiguration untuk mendapatkan WAF.

Jenis:PSApplicationGatewayWebApplicationFirewallConfiguration
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

-Zone

Daftar zona ketersediaan yang menunjukkan asal gateway aplikasi.

Jenis:List<T>[String]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

PSApplicationGatewaySku

PSApplicationGatewaySslPolicy

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

PSApplicationGatewayWebApplicationFirewallConfiguration

Hashtable

Output

PSApplicationGateway