New-AzApplicationGatewayPathRuleConfig
建立應用程式閘道路徑規則。
Syntax
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>]
Description
New-AzApplicationGatewayPathRuleConfig Cmdlet 會建立應用程式閘道路徑規則。 此 Cmdlet 所建立的規則可以新增至 URL 路徑對應組態設定的集合,然後指派給閘道。 路徑對應組態設定用於應用程式閘道負載平衡。
範例
範例 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
這些命令會建立新的應用程式閘道路徑規則,然後使用 Add-AzApplicationGatewayUrlPathMapConfig Cmdlet 將該規則指派給應用程式閘道。 若要這樣做,第一個命令會建立閘道 ContosoApplicationGateway 的物件參考。 此物件參考會儲存在名為 $Gateway的變數中。 接下來的兩個命令會建立後端位址池和後端 HTTP 設定物件;為了建立路徑規則物件,需要這些物件(儲存在變數$AddressPool和$Http設定中)。 第四個命令會建立路徑規則物件,並儲存在名為 $PathRuleConfig的變數中。 第五個命令會使用 Add-AzApplicationGatewayUrlPathMapConfig ,將這些設定中包含的組態設定和新的路徑規則新增至 ContosoApplicationGateway。
範例 2
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy
這些命令會建立路徑規則,其名稱為 「base」、Path as “/base”、“BackendAddressPool as $AddressPool、BackendHttp 設定 as $Http設定 和 FirewallPolicy 作為 $firewallPolicy.ngs,以及 ContosoApplicationGateway 內含的新路徑規則。
參數
-BackendAddressPool
指定要新增至閘道路徑規則組態設定之後端位址池設定集合的物件參考。
您可以使用 New-AzApplicationGatewayBackendAddressPool Cmdlet 和類似以下的語法來建立此物件參考:$AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
上述命令會將兩個IP位址(192.16.1.1和192.168.1.2)新增至位址池。
請注意,IP 位址會以引號括住,並使用逗號分隔。
產生的變數,$AddressPool,然後可用來作為 DefaultBackendAddressPool 參數的參數值。
後端位址池代表後端伺服器上的IP位址。
這些IP位址應屬於虛擬網路子網,或應該是公用IP位址。
如果您使用此參數,就無法 在同一個命令中使用DefaultBackendAddressPoolId 參數。
Type: | PSApplicationGatewayBackendAddressPool |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackendAddressPoolId
指定可新增至閘道路徑規則組態設定的現有後端位址池標識碼。 您可以使用 Get-AzApplicationGatewayBackendAddressPool Cmdlet 來傳回位址池標識符。 取得標識符之後,您就可以使用 DefaultBackendAddressPoolId 參數,而不是 DefaultBackendAddressPool 參數。 例如:-DefaultBackendAddressPoolId “/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool”後端位址池代表後端伺服器上的 IP 位址。 這些IP位址應屬於虛擬網路子網,或應該是公用IP位址。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackendHttpSettings
指定要新增至閘道路徑規則組態設定之後端 HTTP 設定集合的物件參考。 您可以使用 New-AzApplicationGatewayBackendHttp 設定 Cmdlet 和類似如下的語法來建立此物件參考:$Http設定 = New-AzApplicationGatewayBackendHttp 設定 -Name “ContosoHttp 設定” -Port 80 -Protocol “Http” -CookieBasedAffinity “Disabled” 產生的變數,$Http設定,然後可作為 的參數值使用DefaultBackendAddressPool 參數:-DefaultBackendHttp 設定 $Http設定 後端 HTTP 設定會設定後端集區的埠、通訊協定和 Cookie 型親和性等屬性。 如果您使用此參數,就無法在同一個命令中使用DefaultBackendHttp 設定Id參數。
Type: | PSApplicationGatewayBackendHttpSettings |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackendHttpSettingsId
指定可新增至閘道路徑規則組態設定的現有後端 HTTP 設定集合識別碼。 您可以使用 Get-AzApplicationGatewayBackendHttp 設定 Cmdlet 來傳回 HTTP 設定識別符。 取得標識符之後,您就可以使用DefaultBackendHttp 設定Id參數,而不是DefaultBackendHttp 設定 參數。 例如:-DefaultBackend 設定 標識符 “/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp 設定 Collection/ContosoHttp 設定” 後端 HTTP 設定會設定埠、通訊協定等屬性 和後端集區的 Cookie 型親和性。 如果您使用此參數,就無法在同一個命令中使用DefaultBackendHttp 設定 參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirewallPolicy
指定最上層防火牆原則的對象參考。 您可以使用 New-AzApplicationGatewayWebApplicationFirewallPolicy Cmdlet 來建立對象參考。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name “wafPolicy1” -ResourceGroup “rgName” 使用上述 commandlet 建立的防火牆原則可以在路徑規則層級參考。 上述命令會建立默認原則設定和受控規則。 使用者可以使用 New-AzApplicationGatewayFirewallPolicy 設定 和 New-AzApplicationGatewayFirewallPolicyManagedRules 來指定 Policy 設定 ManagedRules,而不是預設值。
Type: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirewallPolicyId
指定現有最上層 Web 應用程式防火牆資源的識別碼。
您可以使用 Get-AzApplicationGatewayWebApplicationFirewallPolicy Cmdlet 來傳回防火牆原則標識符。
取得標識符之後,您可以使用 FirewallPolicyId 參數, 而不是 FirewallPolicy 參數。
例如:-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
指定此 Cmdlet 建立的路徑規則組態名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Paths
指定一或多個應用程式閘道路徑規則。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RedirectConfiguration
應用程式閘道 RedirectConfiguration
Type: | PSApplicationGatewayRedirectConfiguration |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RedirectConfigurationId
應用程式閘道 RedirectConfiguration 的標識碼
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RewriteRuleSet
應用程式閘道 RewriteRuleSet
Type: | PSApplicationGatewayRewriteRuleSet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RewriteRuleSetId
應用程式閘道 RewriteRuleSet 的識別碼
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
None
輸出
相關連結
- Add-AzApplicationGatewayUrlPathMapConfig
- Get-AzApplicationGateway
- Get-AzApplicationGatewayUrlPathMapConfig
- New-AzApplicationGatewayBackendAddressPool
- New-AzApplicationGatewayBackendHttpSetting
- New-AzApplicationGatewayPathRuleConfig
- New-AzApplicationGatewayUrlPathMapConfig
- Remove-AzApplicationGatewayUrlPathMapConfig
- Set-AzApplicationGatewayUrlPathMapConfig
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應