共用方式為

New-AzureRmApplicationGatewayPathRuleConfig

  • 參考
模組:
AzureRM.Network

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

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

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

Description

New-AzureRmApplicationGatewayPathRuleConfig Cmdlet 會建立應用程式網關路徑規則。 此 Cmdlet 所建立的規則可以新增至 URL 路徑對應組態設定的集合，然後指派給閘道。 路徑對應組態設定用於應用程式閘道負載平衡。

範例

範例 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

這些命令會建立新的應用程式閘道路徑規則，然後使用 Add-AzureRmApplicationGatewayUrlPathMapConfig Cmdlet 將該規則指派給應用程式閘道。 若要這樣做，第一個命令會建立閘道 ContosoApplicationGateway 的物件參考。 此物件參考會儲存在名為 $Gateway的變數中。 接下來的兩個命令會建立後端位址池和後端 HTTP 設定物件;為了建立路徑規則物件，需要這些物件（儲存在變數$AddressPool和$HttpSettings中）。 第四個命令會建立路徑規則物件，並儲存在名為 $PathRuleConfig的變數中。 第五個命令會使用 Add-AzureRmApplicationGatewayUrlPathMapConfig 將組態設定和包含在這些設定內的新路徑規則新增至 ContosoApplicationGateway。

參數

-BackendAddressPool

指定要新增至閘道路徑規則組態設定之後端位址池設定集合的物件參考。 您可以使用 New-AzureRmApplicationGatewayBackendAddressPool Cmdlet 和類似以下的語法來建立此物件參考：$AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BackendAddressPoolId

指定可新增至閘道路徑規則組態設定的現有後端位址池標識碼。 您可以使用 Get-AzureRmApplicationGatewayBackendAddressPool Cmdlet 來傳回位址池標識符。 取得標識符之後，您就可以使用 DefaultBackendAddressPoolId 參數，而不是 DefaultBackendAddressPool 參數。 例如：-DefaultBackendAddressPoolId “/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool” 後端位址池代表後端伺服器上的 IP 位址。 這些IP位址應屬於虛擬網路子網，或應該是公用IP位址。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BackendHttpSettings

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

類型:PSApplicationGatewayBackendHttpSettings
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BackendHttpSettingsId

指定可新增至閘道路徑規則組態設定的現有後端 HTTP 設定集合識別碼。 您可以使用 Get-AzureRmApplicationGatewayBackendHttpSettings 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
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定此 Cmdlet 建立的路徑規則組態名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Paths

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

類型:List<T>[String]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-RedirectConfiguration

應用程式閘道 RedirectConfiguration

類型:PSApplicationGatewayRedirectConfiguration
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RedirectConfigurationId

應用程式閘道 RedirectConfiguration 的標識碼

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

PSApplicationGatewayPathRule