Bagikan melalui

New-AzureRmApplicationGatewayPathRuleConfig

  • Referensi
Modul:
AzureRM.Network

Membuat aturan jalur 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-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RedirectConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
   [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
   [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzureRmApplicationGatewayPathRuleConfig membuat aturan jalur gateway aplikasi. Aturan yang dibuat oleh cmdlet ini dapat ditambahkan ke kumpulan pengaturan konfigurasi peta jalur URL lalu ditetapkan ke gateway. Pengaturan konfigurasi peta jalur digunakan dalam penyeimbangan beban gateway aplikasi.

Contoh

Contoh 1

PS C:\>$Gateway = Get-AzureRmApplicationGateway -Name "ContosoApplicationGateway"
PS C:\> $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
PS C:\> $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $PathRuleConfig = New-AzureRmApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
PS C:\> Add-AzureRmApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

Perintah ini membuat aturan jalur gateway aplikasi baru lalu menggunakan cmdlet Add-AzureRmApplicationGatewayUrlPathMapConfig untuk menetapkan aturan tersebut ke gateway aplikasi. Untuk melakukan ini, perintah pertama membuat referensi objek ke gateway ContosoApplicationGateway. Referensi objek ini disimpan dalam variabel bernama $Gateway. Dua perintah berikutnya membuat kumpulan alamat backend dan objek pengaturan HTTP backend; objek ini (disimpan dalam variabel $AddressPool dan $Http Pengaturan) diperlukan untuk membuat objek aturan jalur. Perintah keempat membuat objek aturan jalur dan disimpan dalam variabel bernama $PathRuleConfig. Perintah kelima menggunakan Add-AzureRmApplicationGatewayUrlPathMapConfig untuk menambahkan pengaturan konfigurasi dan aturan jalur baru yang terkandung dalam pengaturan tersebut ke ContosoApplicationGateway.

Parameter

-BackendAddressPool

Menentukan referensi objek ke kumpulan pengaturan kumpulan alamat backend yang akan ditambahkan ke pengaturan konfigurasi aturan jalur gateway. Anda dapat membuat referensi objek ini dengan menggunakan cmdlet dan sintaks New-AzureRmApplicationGatewayBackendAddressPool yang mirip dengan ini: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Perintah sebelumnya menambahkan dua alamat IP (192.16.1.1 dan 192.168.1.2) ke kumpulan alamat. Perhatikan bahwa alamat IP diapit dalam tanda kutip dan dipisahkan dengan menggunakan koma. Variabel yang dihasilkan, $AddressPool, kemudian dapat digunakan sebagai nilai parameter untuk parameter DefaultBackendAddressPool . Kumpulan alamat backend mewakili alamat IP di server backend. Alamat IP ini harus milik subnet jaringan virtual atau harus alamat IP publik. Jika Anda menggunakan parameter ini, Anda tidak dapat menggunakan parameter DefaultBackendAddressPoolId dalam perintah yang sama.

Jenis:PSApplicationGatewayBackendAddressPool
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendAddressPoolId

Menentukan ID kumpulan alamat backend yang sudah ada yang dapat ditambahkan ke pengaturan konfigurasi aturan jalur gateway. ID kumpulan alamat dapat dikembalikan dengan menggunakan cmdlet Get-AzureRmApplicationGatewayBackendAddressPool. Setelah memiliki ID, Anda kemudian dapat menggunakan parameter DefaultBackendAddressPoolId alih-alih parameter DefaultBackendAddressPool . Misalnya: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Kumpulan alamat backend mewakili alamat IP di server backend. Alamat IP ini harus milik subnet jaringan virtual atau harus alamat IP publik.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendHttpSettings

Menentukan referensi objek ke kumpulan pengaturan HTTP backend yang akan ditambahkan ke pengaturan konfigurasi aturan jalur gateway. Anda dapat membuat referensi objek ini dengan menggunakan cmdlet dan sintaks New-AzureRmApplicationGatewayBackendHttp Pengaturan mirip dengan ini: $Http Pengaturan = New-AzureRmApplicationGatewayBackendHttp Pengaturan -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Variabel yang dihasilkan, $Http Pengaturan, kemudian dapat digunakan sebagai nilai parameter untuk parameter DefaultBackendAddressPool: -DefaultBackendHttp Pengaturan $Http Pengaturan Pengaturan HTTP backend mengonfigurasi properti seperti port, protokol, dan afinitas berbasis cookie untuk kumpulan backend. Jika Anda menggunakan parameter ini, Anda tidak dapat menggunakan parameter DefaultBackendHttp Pengaturan Id dalam perintah yang sama.

Jenis:PSApplicationGatewayBackendHttpSettings
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendHttpSettingsId

Menentukan ID kumpulan pengaturan HTTP backend yang sudah ada yang dapat ditambahkan ke pengaturan konfigurasi aturan jalur gateway. ID pengaturan HTTP dapat dikembalikan dengan menggunakan cmdlet Get-AzureRmApplicationGatewayBackendHttp Pengaturan. Setelah Anda memiliki ID, Anda kemudian dapat menggunakan parameter DefaultBackendHttp Pengaturan Id alih-alih parameter DefaultBackendHttp Pengaturan. Misalnya: -DefaultBackend Pengaturan Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Pengaturan Collection/ContosoHttp Pengaturan" Pengaturan HTTP backend mengonfigurasi properti seperti port, protokol, dan afinitas berbasis cookie untuk kumpulan backend. Jika Anda menggunakan parameter ini, Anda tidak dapat menggunakan parameter DefaultBackendHttp Pengaturan dalam perintah yang sama.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-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 konfigurasi aturan jalur yang dibuat cmdlet ini.

Jenis:String
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-Paths

Menentukan satu atau beberapa aturan jalur gateway aplikasi.

Jenis:List<T>[String]
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfiguration

Pengalihan Gateway AplikasiKonfigurasi Ulang

Jenis:PSApplicationGatewayRedirectConfiguration
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfigurationId

ID RedirectConfiguration gateway aplikasi

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

PSApplicationGatewayPathRule