Udostępnij za pośrednictwem

New-AzFrontDoorRulesEngineRuleObject

  • Odwołanie
Moduł:
Az.FrontDoor

Utwórz obiekt PSRulesEngineRule na potrzeby tworzenia aparatu reguł.

Składnia

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

Opis

Utwórz obiekt PSRulesEngineRule na potrzeby tworzenia aparatu reguł.

Użyj polecenia cmdlet "New-AzFrontDoorRulesEngineActionObject", aby utworzyć obiekt PSRulesEngineAction w celu przekazania do parametru "-Action". Użyj polecenia cmdlet "New-AzFrontDoorRulesEngineMatchConditionObject", aby utworzyć obiekt PSRulesEngineMatchCondition, aby przekazać go do parametru "-MatchCondition".

Przykłady

Przykład 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}

Utwórz nowy obiekt PSRulesEngineRule i pokaż, jak wyświetlić pola podrzędne.

Przykład 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

Oczekiwano danych wyjściowych podczas przekazywania nieprawidłowej wartości priorytetu.

Parametry

-Action

Akcje do wykonania w żądaniu i odpowiedzi, jeśli zostaną spełnione wszystkie warunki dopasowania.

Typ:PSRulesEngineAction
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MatchCondition

Lista warunków dopasowania, które muszą spełniać w celu uruchomienia akcji tej reguły. Brak warunków dopasowania oznacza, że akcje będą zawsze uruchamiane.

Typ:PSRulesEngineMatchCondition[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MatchProcessingBehavior

Jeśli ta reguła jest zgodna, aparat reguł powinien kontynuować działanie pozostałych reguł lub zatrzymać. Możliwe wartości to Kontynuuj i Zatrzymaj. Jeśli nie jest obecny, wartość domyślna to Kontynuuj.

Typ:PSMatchProcessingBehavior
Dopuszczalne wartości:Continue, Stop
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa odwołująca się do tej konkretnej reguły.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Priority

Priorytet przypisany do tej reguły. Nie może być ujemna.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe