你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzFrontDoorRoutingRuleObject

参考

模块:: Az.FrontDoor

创建用于创建 Front Door 的 PSRoutingRuleObject

语法

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

说明

创建用于创建 Front Door 的 PSRoutingRuleObject

示例

示例 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                         :

创建用于创建 Front Door 的 PSRoutingRuleObject

参数

-AcceptedProtocol

要为此规则匹配的协议方案。默认值为 {Https, Http}

类型:	PSProtocol[]
接受的值:	Http, Https
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BackendPoolName

此规则将路由到的 BackendPool 的资源 ID

类型:	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

通过

New-AzFrontDoorRoutingRuleObject

语法

说明

示例

示例 1：使用转发规则为 Front Door 创建创建 PSRoutingRuleObject

示例 2：使用重定向规则创建用于 Front Door 创建的 PSRoutingRuleObject

参数

-AcceptedProtocol

-BackendPoolName

-CustomForwardingPath

-CustomFragment

-CustomHost

-CustomPath

-CustomQueryString

-DefaultProfile

-DynamicCompression

-EnableCaching

-EnabledState

-ForwardingProtocol

-FrontDoorName

-FrontendEndpointName

-Name

-PatternToMatch

-QueryParameterStripDirective

-RedirectProtocol

-RedirectType

-ResourceGroupName

-RulesEngineName

输入

输出

其他资源

通过

New-AzFrontDoorRoutingRuleObject

语法

说明

示例

示例 1：使用转发规则为 Front Door 创建创建 PSRoutingRuleObject

示例 2：使用重定向规则创建用于 Front Door 创建的 PSRoutingRuleObject

参数

-AcceptedProtocol

-BackendPoolName

-CustomForwardingPath

-CustomFragment

-CustomHost

-CustomPath

-CustomQueryString

-DefaultProfile

-DynamicCompression

-EnableCaching

-EnabledState

-ForwardingProtocol

-FrontDoorName

-FrontendEndpointName

-Name

-PatternToMatch

-QueryParameterStripDirective

-RedirectProtocol

-RedirectType

-ResourceGroupName

-RulesEngineName

输入

输出

相关链接

其他资源