New-AzApplicationGatewayPathRuleConfig

Modul:
Az.Network Module

Membuat aturan jalur gateway aplikasi.

Sintaks

SetByResourceId 

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPoolId <String>]
    [-BackendHttpSettingsId <String>]
    [-RewriteRuleSetId <String>]
    [-RedirectConfigurationId <String>]
    [-FirewallPolicyId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

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 $HttpSettings) 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, BackendHttpSettings sebagai $HttpSettings 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 New-AzApplicationGatewayBackendAddressPool dan sintaks 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.

Properti parameter

Jenis:PSApplicationGatewayBackendAddressPool
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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 New-AzApplicationGatewayBackendHttpSettings dan sintaks yang mirip dengan ini: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Dinonaktifkan" Variabel yang dihasilkan, $HttpSettings, kemudian dapat digunakan sebagai nilai parameter untuk parameter DefaultBackendAddressPool : -DefaultBackendHttpSettings $HttpSettings 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 DefaultBackendHttpSettingsId dalam perintah yang sama.

Properti parameter

Jenis:PSApplicationGatewayBackendHttpSettings
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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-AzApplicationGatewayBackendHttpSettings. Setelah Anda memiliki ID, Anda kemudian dapat menggunakan parameter DefaultBackendHttpSettingsId alih-alih parameter DefaultBackendHttpSettings . Misalnya: id -DefaultBackendSettings "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft. Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" 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 DefaultBackendHttpSettings dalam perintah yang sama.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DefaultProfile

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

Properti parameter

Jenis:IAzureContextContainer
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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 cmdlet 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 PolicySettings, ManagedRules dengan menggunakan New-AzApplicationGatewayFirewallPolicySettings dan New-AzApplicationGatewayFirewallPolicyManagedRules masing-masing.

Properti parameter

Jenis:PSApplicationGatewayWebApplicationFirewallPolicy
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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>

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

Menentukan nama konfigurasi aturan jalur yang dibuat cmdlet ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Paths

Menentukan satu atau beberapa aturan jalur gateway aplikasi.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-RedirectConfiguration

Pengalihan Gateway AplikasiKonfigurasi Ulang

Properti parameter

Jenis:PSApplicationGatewayRedirectConfiguration
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-RedirectConfigurationId

ID RedirectConfiguration gateway aplikasi

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-RewriteRuleSet

RewriteRuleSet gateway aplikasi

Properti parameter

Jenis:PSApplicationGatewayRewriteRuleSet
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-RewriteRuleSetId

ID gateway aplikasi RewriteRuleSet

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Output

PSApplicationGatewayPathRule