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

New-AzFrontDoorRulesEngineActionObject

参考

模块:: Az.FrontDoor

创建用于创建规则引擎规则的 PSRulesEngineAction 对象。

语法

New-AzFrontDoorRulesEngineActionObject
   [-RequestHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-ResponseHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzFrontDoorRulesEngineActionObject
   [-RequestHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-ResponseHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-CustomForwardingPath <String>]
   [-ForwardingProtocol <String>]
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -BackendPoolName <String>
   [-EnableCaching <Boolean>]
   [-QueryParameterStripDirective <String>]
   [-DynamicCompression <PSEnabledState>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzFrontDoorRulesEngineActionObject
   [-RequestHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-ResponseHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-RedirectType <String>]
   [-RedirectProtocol <String>]
   [-CustomHost <String>]
   [-CustomPath <String>]
   [-CustomFragment <String>]
   [-CustomQueryString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

创建用于创建规则引擎规则的 PSRulesEngineAction 对象。

使用 cmdlet“New-AzFrontDoorHeaderActionObject”创建 PSHeaderObjects 以传入参数“-RequestHeaderActions”和“-ResponseHeaderActions”。

示例

示例 1

$headerActions = New-AzFrontDoorHeaderActionObject -HeaderActionType "Append" -HeaderName "X-Content-Type-Options" -Value "nosniff"
$headerActions

HeaderName             HeaderActionType Value
----------             ---------------- -----
X-Content-Type-Options           Append nosniff

$rulesEngineAction = New-AzFrontDoorRulesEngineActionObject -ResponseHeaderAction $headerActions
$rulesEngineAction

RequestHeaderActions ResponseHeaderActions    RouteConfigurationOverride
-------------------- ---------------------    --------------------------
{}                   {X-Content-Type-Options}

创建一个规则引擎操作，该操作追加响应标头值并演示如何查看创建的规则引擎操作的属性。

示例 2

$rulesEngineAction = New-AzFrontDoorRulesEngineActionObject -RequestHeaderAction $headerActions -ForwardingProtocol HttpsOnly -BackendPoolName mybackendpool -ResourceGroupName Jessicl-Test-RG -FrontDoorName jessicl-test-myappfrontend -QueryParameterStripDirective StripNone -DynamicCompression Disabled -EnableCaching $true
$rulesEngineAction

RequestHeaderAction            ResponseHeaderAction RouteConfigurationOverride
-------------------            -------------------- --------------------------
{headeraction1, headeraction2} {}                   Microsoft.Azure.Commands.FrontDoor.Models.PSForwardingConfiguration

$rulesEngineAction.RequestHeaderAction

HeaderName    HeaderActionType Value
----------    ---------------- -----
headeraction1        Overwrite
headeraction2           Append

$rulesEngineAction.ResponseHeaderAction
$rulesEngineAction.RouteConfigurationOverride

CustomForwardingPath         :
ForwardingProtocol           : HttpsOnly
BackendPoolId                : /subscriptions/47f4bc68-6fe4-43a2-be8b-dfd0e290efa2/resourceGroups/myresourcegroup/provi
                               ders/Microsoft.Network/frontDoors/myfrontdoor/BackendPools/mybackendpool
QueryParameterStripDirective : StripNone
DynamicCompression           : Disabled
EnableCaching                : True

创建一个规则引擎操作，用于将请求转发到后台池，并演示如何查看创建的规则引擎操作的属性。

示例 3

$rulesEngineAction = New-AzFrontDoorRulesEngineActionObject -RedirectType Moved -RedirectProtocol MatchRequest -CustomHost www.contoso.com
$rulesEngineAction

RequestHeaderActions ResponseHeaderActions RouteConfigurationOverride
-------------------- --------------------- --------------------------
{}                   {}                    Microsoft.Azure.Commands.FrontDoor.Models.PSRedirectConfiguration

$rulesEngineAction.RouteConfigurationOverride

RedirectType      : Moved
RedirectProtocol  : MatchRequest
CustomHost        : www.contoso.com
CustomPath        :
CustomFragment    :
CustomQueryString :

创建将请求重定向到另一个主机的规则引擎操作，并演示如何查看创建的规则引擎操作的属性。

参数

-BackendPoolName

此规则路由到的 BackendPool 的名称

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomForwardingPath

用于重写此规则匹配的资源路径的自定义路径。保留为空以使用传入路径。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomFragment

要添加到重定向 URL 的片段。片段是 #之后 URL 的一部分。请勿包含 #。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomHost

要重定向的主机。将传入主机保留为空，以将传入主机用作目标主机。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomPath

要重定向的完整路径。路径不能为空，必须以 /开头。将传入路径保留为空，以用作目标路径。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomQueryString

要放置在重定向 URL 中的查询字符串集。设置此值将替换任何现有查询字符串;保留空以保留传入的查询字符串。查询字符串必须采用 <key>=<value> 格式。第一个？和 & 将自动添加，因此不要在前面包含它们，但使用 > 分隔多个查询字符串。

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

-DynamicCompression

是否为缓存内容启用动态压缩。默认值为“Enabled”

Type:	PSEnabledState
Accepted values:	Enabled, Disabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableCaching

是否要为此路由启用高速缓存。默认值为“false”

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForwardingProtocol

将流量转发到后端时，此规则将使用的协议。默认值为 MatchRequest

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FrontDoorName

此路由规则所属的 Front Door 的名称。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-QueryParameterStripDirective

形成缓存键时对 URL 查询词的处理。默认值为“StripAll”

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectProtocol

将流量重定向到的目标的协议。默认值为 MatchRequest

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectType

重定向流量时规则将使用的重定向类型。默认值已移动

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestHeaderAction

要从 AFD 到源的请求中应用的标头操作列表。

Type:	List<T>[PSHeaderAction]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

将在其中创建 RoutingRule 的资源组名称。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResponseHeaderAction

要从 AFD 响应应用到客户端的标头操作的列表。

Type:	List<T>[PSHeaderAction]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

PSRulesEngineAction

Share via