New-AzApplicationGatewayPathRuleConfig

  • Referensi
Modul:
Az.Network

Membuat aturan jalur gateway aplikasi.

Sintaks

New-AzApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <String[]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RewriteRuleSetId <String>]
   [-RedirectConfigurationId <String>]
   [-FirewallPolicyId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <String[]>
   [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
   [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
   [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
   [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
   [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzApplicationGatewayPathRuleConfig 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

$Gateway = Get-AzApplicationGateway -Name "ContosoApplicationGateway"
$AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
$HttpSettings = New-AzApplicationGatewayBackendHttpSetting -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
Add-AzApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

Perintah ini membuat aturan jalur gateway aplikasi baru lalu menggunakan cmdlet Add-AzApplicationGatewayUrlPathMapConfig 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-AzApplicationGatewayUrlPathMapConfig untuk menambahkan pengaturan konfigurasi dan aturan jalur baru yang terkandung dalam pengaturan tersebut ke ContosoApplicationGateway.

Contoh 2

$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy

Perintah ini membuat aturan jalur dengan Nama sebagai "dasar", Jalur sebagai "/base", BackendAddressPool sebagai $AddressPool, BackendHttp Pengaturan sebagai $Http Pengaturan dan FirewallPolicy sebagai $firewallPolicy.ngs 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-AzApplicationGatewayBackendAddressPool yang mirip dengan ini: $AddressPool = New-AzApplicationGatewayBackendAddressPool -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.

Type:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
Required: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-AzApplicationGatewayBackendAddressPool. 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.

Type:String
Position:Named
Default value:None
Required: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-AzApplicationGatewayBackendHttp Pengaturan mirip dengan ini: $Http Pengaturan = New-AzApplicationGatewayBackendHttp Pengaturan -Name "ContosoHttp Pengaturan" -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.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Required: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-AzApplicationGatewayBackendHttp 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

Menentukan referensi objek ke kebijakan firewall tingkat atas. Referensi objek dapat dibuat dengan menggunakan cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Kebijakan firewall yang dibuat menggunakan commandlet di atas dapat dirujuk pada tingkat aturan jalur. perintah dia di atas akan membuat pengaturan kebijakan default dan aturan terkelola. Alih-alih nilai default, pengguna dapat menentukan Policy Pengaturan, ManagedRules dengan menggunakan New-AzApplicationGatewayFirewallPolicy Pengaturan dan New-AzApplicationGatewayFirewallPolicyManagedRules masing-masing.

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicyId

Menentukan ID sumber daya firewall aplikasi web tingkat atas yang ada. ID kebijakan firewall dapat dikembalikan dengan menggunakan cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Setelah kami memiliki ID, Anda dapat menggunakan parameter FirewallPolicyId alih-alih parameter FirewallPolicy . Misalnya: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama konfigurasi aturan jalur yang dibuat cmdlet ini.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Paths

Menentukan satu atau beberapa aturan jalur gateway aplikasi.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfiguration

Pengalihan Gateway AplikasiKonfigurasi Ulang

Type:PSApplicationGatewayRedirectConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfigurationId

ID RedirectConfiguration gateway aplikasi

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RewriteRuleSet

RewriteRuleSet gateway aplikasi

Type:PSApplicationGatewayRewriteRuleSet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RewriteRuleSetId

ID gateway aplikasi RewriteRuleSet

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

PSApplicationGatewayPathRule