共用方式為

New-AzApplicationGatewayPathRuleConfig

模組:
Az.Network Module

建立應用程式閘道路徑規則。

語法

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>]

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 和 $HttpSettings 中）。 第四個命令會建立路徑規則物件，並儲存在名為 $PathRuleConfig 的變數中。 第五個命令會使用 Add-AzApplicationGatewayUrlPathMapConfig 將組態設定和這些設定中包含的新路徑規則新增至 ContosoApplicationGateway。

範例 2

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

這些命令會建立路徑規則，其中名稱為 “base”，路徑為 “/base”，BackendAddressPool 為 $AddressPool，BackendHttpSettings 為 $HttpSettings，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 參數。

參數屬性

類型:PSApplicationGatewayBackendAddressPool
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-BackendAddressPoolId

指定可新增至閘道路徑規則組態設定的現有後端位址集區的 ID。 您可以使用 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 位址。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-BackendHttpSettings

指定要新增至閘道路徑規則組態設定的後端 HTTP 設定集合的物件參照。 您可以使用類似下列的 New-AzApplicationGatewayBackendHttpSettings Cmdlet 和語法來建立此物件參考： $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name “ContosoHttpSettings” -Port 80 -Protocol “Http” -CookieBasedAffinity “Disabled” 產生的變數 $HttpSettings 然後可以作為 DefaultBackendAddressPool 參數的參數值： -DefaultBackendHttpSettings $HttpSettings 後端 HTTP 設定會設定後端集區的屬性，例如埠、通訊協定和 Cookie 型親和性。 如果您使用此參數，則無法在相同的命令中使用 DefaultBackendHttpSettingsId 參數。

參數屬性

類型:PSApplicationGatewayBackendHttpSettings
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-BackendHttpSettingsId

指定可新增至閘道路徑規則組態設定的現有後端 HTTP 設定集合的 ID。 您可以使用 Get-AzApplicationGatewayBackendHttpSettings Cmdlet 傳回 HTTP 設定識別碼。 取得識別碼之後，您可以使用 DefaultBackendHttpSettingsId 參數，而不是 DefaultBackendHttpSettings 參數。 例如：-DefaultBackendSettings ID “/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings” 後端 HTTP 設定會設定後端集區的屬性，例如埠、通訊協定和 Cookie 型親和性。 如果您使用此參數，則無法在相同的命令中使用 DefaultBackendHttpSettings 參數。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FirewallPolicy

指定最上層防火牆原則的物件參考。 您可以使用 Cmdlet 建立物件參考 New-AzApplicationGatewayWebApplicationFirewallPolicy。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name “wafPolicy1” -ResourceGroup “rgName” 使用上述 Cmdlet 建立的防火牆原則可以在路徑規則層級參考。 上述命令將創建默認策略設置和託管規則。 使用者可以分別使用 New-AzApplicationGatewayFirewallPolicySettings 和 New-AzApplicationGatewayFirewallPolicyManagedRules 來指定 PolicySettings、ManagedRules，而不是預設值。

參數屬性

類型:PSApplicationGatewayWebApplicationFirewallPolicy
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FirewallPolicyId

指定現有最上層 Web 應用程式防火牆資源的 ID。 您可以使用 Get-AzApplicationGatewayWebApplicationFirewallPolicy Cmdlet 傳回防火牆原則識別碼。 取得識別碼之後，您可以使用 FirewallPolicyId 參數，而不是 FirewallPolicy 參數。 例如：-FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定此 Cmdlet 所建立的路徑規則設定名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Paths

指定一或多個應用程式閘道路徑規則。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RedirectConfiguration

應用程式閘道重新導向組態

參數屬性

類型:PSApplicationGatewayRedirectConfiguration
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RedirectConfigurationId

應用程式閘道 RedirectConfiguration 的識別碼

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RewriteRuleSet

應用程式閘道 RewriteRuleSet

參數屬性

類型:PSApplicationGatewayRewriteRuleSet
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RewriteRuleSetId

應用程式閘道 RewriteRuleSet 的識別碼

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

輸出

PSApplicationGatewayPathRule