共用方式為

New-AzFrontDoorRoutingRuleObject

  • 參考
模組:
Az.FrontDoor

建立 PSRoutingRuleObject 以建立 Front Door

語法

New-AzFrontDoorRoutingRuleObject
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -Name <String>
   -FrontendEndpointName <String[]>
   -BackendPoolName <String>
   [-AcceptedProtocol <PSProtocol[]>]
   [-PatternToMatch <String[]>]
   [-CustomForwardingPath <String>]
   [-ForwardingProtocol <String>]
   [-EnableCaching <Boolean>]
   [-QueryParameterStripDirective <String>]
   [-DynamicCompression <PSEnabledState>]
   [-EnabledState <PSEnabledState>]
   [-RulesEngineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzFrontDoorRoutingRuleObject
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -Name <String>
   -FrontendEndpointName <String[]>
   [-AcceptedProtocol <PSProtocol[]>]
   [-PatternToMatch <String[]>]
   [-RedirectType <String>]
   [-RedirectProtocol <String>]
   [-CustomHost <String>]
   [-CustomPath <String>]
   [-CustomFragment <String>]
   [-CustomQueryString <String>]
   [-EnabledState <PSEnabledState>]
   [-RulesEngineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

建立 PSRoutingRuleObject 以建立 Front Door

範例

範例 1：使用轉送規則建立 Front Door 的 PSRoutingRuleObject

New-AzFrontDoorRoutingRuleObject -Name $routingRuleName -FrontDoorName $frontDoorName -ResourceGroupName $rgname -FrontendEndpointName "frontendEndpoint1" -BackendPoolName "backendPool1"

FrontendEndpointIds          : {/subscriptions/{subid}/resourceGroups/{rgname}/pro
                               viders/Microsoft.Network/frontDoors/{frontdoorname}/FrontendEndpoints/frontendEndpoint1}
AcceptedProtocols            : {Http, Https}
PatternsToMatch              : {/*}
HealthProbeSettings          :
RouteConfiguration           : Microsoft.Azure.Commands.FrontDoor.Models.PSForwardingConfiguration
EnabledState                 : Enabled
ResourceState                :
Id                           :
Name                         : {routingRuleName}
Type                         :

範例 2：使用重新導向規則建立 Front Door 的 PSRoutingRuleObject

$customHost = "www.contoso.com"
$customPath = "/images/contoso.png"
$queryString = "field1=value1&field2=value2"
$destinationFragment = "section-header-2"
New-AzFrontDoorRoutingRuleObject -Name $routingRuleName -FrontDoorName $frontDoorName -ResourceGroupName $rgname -FrontendEndpointName "frontendEndpoint1" -CustomHost $customHost -CustomPath $customPath -CustomQueryString $queryString -CustomFragment $destinationFragment

FrontendEndpointIds          : {/subscriptions/{subid}/resourceGroups/{rgname}/pro
                               viders/Microsoft.Network/frontDoors/{frontdoorname}/FrontendEndpoints/frontendEndpoint1}
AcceptedProtocols            : {Http, Https}
PatternsToMatch              : {/*}
HealthProbeSettings          :
RouteConfiguration           : Microsoft.Azure.Commands.FrontDoor.Models.PSRedirectConfiguration
EnabledState                 : Enabled
ResourceState                :
Id                           :
Name                         : {routingRuleName}
Type                         :

建立 PSRoutingRuleObject 以建立 Front Door

參數

-AcceptedProtocol

要符合此規則的通訊協定配置。 默認值為 {Https， Http}

類型:PSProtocol[]
接受的值:Http, Https
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BackendPoolName

此規則路由至的 BackendPool 資源識別碼

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

-CustomForwardingPath

用來重寫此規則所比對之資源路徑的自定義路徑。 保留空白以使用傳入路徑。

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

-CustomFragment

要新增至重新導向 URL 的片段。 片段是之後 URL 的一部分。 請勿包含 #。

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

-CustomHost

要重新導向的主機。 保留空白，以使用傳入主機作為目的地主機。

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

-CustomPath

要重新導向的完整路徑。 路徑不可以是空的，而且必須以 /開頭。 保留空白，以使用傳入路徑作為目的地路徑。

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

-CustomQueryString

要放在重新導向 URL 中的查詢字串集。 設定此值會取代任何現有的查詢字串;保留空白以保留傳入查詢字串。 查詢字串的格式必須為 <key>=<value> 。 第一個 ？ 和 和 會自動新增，因此請勿將它們包含在前面，但會使用 和 分隔多個查詢字串。

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

-DefaultProfile

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

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

-DynamicCompression

是否要在啟用快取時啟用快取內容的動態壓縮。 預設值為 Enabled

類型:PSEnabledState
接受的值:Enabled, Disabled
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-EnableCaching

是否要啟用此路由的快取。 默認值為 false

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

-EnabledState

是否要啟用此規則的使用。 預設值為 Enabled

類型:PSEnabledState
接受的值:Enabled, Disabled
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForwardingProtocol

將流量轉送至後端時，此規則所使用的通訊協議預設值為 MatchRequest。

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

-FrontDoorName

此路由規則所屬的 Front Door 名稱。

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

-FrontendEndpointName

與此規則相關聯的前端端點名稱

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

-Name

RoutingRule 名稱。

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

-PatternToMatch

規則的路由模式，除了路徑結尾的結尾可能之後，不得有任何 * 。 預設值為 /*

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

-QueryParameterStripDirective

形成快取索引鍵時，URL 查詢詞彙的處理方式。 預設值為 StripAll

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

-RedirectProtocol

將流量重新導向目的地的通訊協定。 預設值為 MatchRequest

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

-RedirectType

重新導向類型，規則會在重新導向流量時使用。 預設值已移動

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

-ResourceGroupName

將建立 RoutingRule 的資源組名。

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

-RulesEngineName

要套用至此路由的特定規則引擎組態參考。

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

輸入

None

輸出

PSRoutingRule