New-AzFrontDoorRulesEngineRuleObject

參考

模組:: Az.FrontDoor

建立規則引擎建立的 PSRulesEngineRule 物件。

語法

New-AzFrontDoorRulesEngineRuleObject
   -Name <String>
   -Priority <Int32>
   -Action <PSRulesEngineAction>
   [-MatchProcessingBehavior <PSMatchProcessingBehavior>]
   [-MatchCondition <PSRulesEngineMatchCondition[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

建立規則引擎建立的 PSRulesEngineRule 物件。

使用 Cmdlet “New-AzFrontDoorRulesEngineActionObject” 來建立 PSRulesEngineAction 物件，以傳遞至 “-Action” 參數。使用 Cmdlet “New-AzFrontDoorRulesEngineMatchConditionObject” 來建立 PSRulesEngineMatchCondition 物件，以傳遞至 “-MatchCondition” 參數。

範例

範例 1

New-AzFrontDoorRulesEngineRuleObject -Name rules1 -Priority 0 -Action $rulesEngineAction -MatchProcessingBehavior Stop -MatchCondition $rulesEngineMatchCondition

Name                    : rules1
Priority                : 0
MatchProcessingBehavior : Stop
MatchCondition          : {Microsoft.Azure.Commands.FrontDoor.Models.PSRulesEngineMatchCondition}
Action                  : Microsoft.Azure.Commands.FrontDoor.Models.PSRulesEngineAction


$rulesEngineRule1.Action

RequestHeaderActions           ResponseHeaderActions RouteConfigurationOverride
--------------------           --------------------- --------------------------
{headeraction1, headeraction2} {}                    Microsoft.Azure.Commands.FrontDoor.Models.PSForwardingConfiguration

$rulesEngineRule1.MatchCondition[0]

RulesEngineMatchVariable : RequestHeader
RulesEngineMatchValue    : {allowoverride}
Selector                 : Rules-Engine-Route-Forward
RulesEngineOperator      : Equal
NegateCondition          : False
Transforms               : {Lowercase, Uppercase}

建立新的 PSRulesEngineRule 物件，並示範如何查看子字段。

範例 2

New-AzFrontDoorRulesEngineRuleObject -Name rules1 -Priority -1

New-AzFrontDoorRulesEngineRuleObject : Cannot validate argument on parameter 'Priority'. The -1 argument is less than the minimum allowed range of 0. Supply an argument that is greater than or equal to 0 and then try the command again.
At line:1 char:81
+ ... ule1 = New-AzFrontDoorRulesEngineRuleObject -Name rules1 -Priority -1
+                                                                        ~~
+ CategoryInfo          : InvalidData: (:) [New-AzFrontDoorRulesEngineRuleObject], ParameterBindingValidationException
+ FullyQualifiedErrorId : ParameterArgumentValidationError,Microsoft.Azure.Commands.FrontDoor.Cmdlets.NewFrontDoorRulesEngineRuleObject

傳入無效的優先順序值時，預期輸出。

參數

-Action

如果符合所有比對條件，則對要求和回應執行的動作。

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

-DefaultProfile

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

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

-MatchCondition

必須符合的比對條件清單，才能執行此規則的動作。沒有相符條件表示動作一律會執行。

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

-MatchProcessingBehavior

如果此規則相符，規則引擎應該繼續執行其餘規則或停止。可能的值為 Continue 和 Stop。如果不存在，則預設為 [繼續]。

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

-Name

要參考此特定規則的名稱。

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

-Priority

指派給此規則的優先順序。不可以是負數。

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

輸入

None

輸出

PSRulesEngineRule

共用方式為