Freigeben über

New-AzFrontDoorRoutingRuleObject

Modul:
Az.FrontDoor Module

Erstellen Sie ein Speicherobjekt für RoutingRule.

Syntax

ByFieldsWithForwardingParameterSet (Standard) 

New-AzFrontDoorRoutingRuleObject
    [-AcceptedProtocol <String[]>]
    [-EnabledState <String>]
    [-FrontendEndpointName <String[]>]
    [-Name <String>]
    [-ResourceGroupName <String>]
    [-FrontDoorName <String>]
    [-PatternsToMatch <String[]>]
    [-RouteConfiguration <IRouteConfiguration>]
    [-RuleEngineName <String>]
    [-WebApplicationFirewallPolicyLinkId <String>]
    [-Id <String>]
    [-BackendPoolName <String>]
    [-CacheDuration <TimeSpan>]
    [-DynamicCompression <String>]
    [-QueryParameter <String>]
    [-QueryParameterStripDirective <String>]
    [-CustomForwardingPath <String>]
    [-ForwardingProtocol <String>]
    [-EnableCaching <Boolean>]
    [<CommonParameters>]

ByFieldsWithRedirectParameterSet 

New-AzFrontDoorRoutingRuleObject
    [-AcceptedProtocol <String[]>]
    [-EnabledState <String>]
    [-FrontendEndpointName <String[]>]
    [-Name <String>]
    [-ResourceGroupName <String>]
    [-FrontDoorName <String>]
    [-PatternsToMatch <String[]>]
    [-RouteConfiguration <IRouteConfiguration>]
    [-RuleEngineName <String>]
    [-WebApplicationFirewallPolicyLinkId <String>]
    [-Id <String>]
    [-CustomFragment <String>]
    [-CustomHost <String>]
    [-CustomPath <String>]
    [-CustomQueryString <String>]
    [-RedirectProtocol <String>]
    [-RedirectType <String>]
    [<CommonParameters>]

Beschreibung

Erstellen Sie ein Speicherobjekt für RoutingRule.

Beispiele

Beispiel 1: Erstellen eines PSRoutingRuleObjects für die Erstellung von Front Door mit einer Weiterleitungsregel

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

AcceptedProtocol                   : {Http, Https}
EnabledState                       : Enabled
FrontendEndpoint                   : {{
                                       "id": "/subscriptions/{subid}/resourceGroups/{rg}/providers/Microsoft.Network/frontDoors/{fname}/FrontendEndpoints/frontendEndpoint1"
                                     }}
Id                                 :
Name                               :
PatternsToMatch                    : {/*}
ResourceState                      :
RouteConfiguration                 : {
                                       "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
                                       "backendPool": {
                                         "id": "/subscriptions/{subid}/resourceGroups/{rg}/providers/Microsoft.Network/frontDoors/{fname}/BackendPools/backendPool1"
                                       },
                                       "forwardingProtocol": "MatchRequest"
                                     }
RuleEngineId                       :
Type                               :
WebApplicationFirewallPolicyLinkId :

Erstellen eines PSRoutingRuleObject für die Erstellung von Front Door mit einer Weiterleitungsregel

Beispiel 2: Erstellen eines PSRoutingRuleObjects für die Erstellung von Front Door mit einer Umleitungsregel

$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

AcceptedProtocol                   : {Http, Https}
EnabledState                       : Enabled
FrontendEndpoint                   : {{
                                       "id": "/subscriptions/{subid}/resourceGroups/{rg}/providers/Microsoft.Network/frontDoors/{fname}/FrontendEndpoints/frontendEndpoint1"
                                     }}
Id                                 :
Name                               :
PatternsToMatch                    : {/*}
ResourceState                      :
RouteConfiguration                 : {
                                       "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
                                       "redirectType": "Moved",
                                       "redirectProtocol": "MatchRequest",
                                       "customHost": "www.contoso.com",
                                       "customPath": "/images/contoso.png",
                                       "customFragment": "section-header-2",
                                       "customQueryString": "field1=value1\u0026field2=value2"
                                     }
RuleEngineId                       :
Type                               :
WebApplicationFirewallPolicyLinkId :

Erstellen eines PSRoutingRuleObjects für die Erstellung von Front Door

Parameter

-AcceptedProtocol

Protokollschemas, die für diese Regel übereinstimmen.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BackendPoolName

Ressourcen-ID

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CacheDuration

Die Dauer, für die der Inhalt zwischengespeichert werden muss. Zulässiges Format ist im ISO 8601-Format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP erfordert, dass der Wert nicht mehr als ein Jahr ist.

Parametereigenschaften

Typ:TimeSpan
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomForwardingPath

Ein benutzerdefinierter Pfad, der zum Umschreiben von Ressourcenpfaden verwendet wird, die mit dieser Regel übereinstimmen. Lassen Sie leer, um den eingehenden Pfad zu verwenden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomFragment

Fragment, das der Umleitungs-URL hinzugefügt werden soll. Fragment ist der Teil der URL, die nach #kommt. Schließen Sie die Datei "#" nicht ein.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomHost

Host, der umgeleitet werden soll. Lassen Sie leer, um den eingehenden Host als Zielhost zu verwenden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomPath

Der vollständige Pfad zur Umleitung. Der Pfad darf nicht leer sein und muss mit /beginnen. Lassen Sie leer, um den eingehenden Pfad als Zielpfad zu verwenden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomQueryString

Der Satz von Abfragezeichenfolgen, die in der Umleitungs-URL platziert werden sollen. Durch festlegen dieses Werts würde jede vorhandene Abfragezeichenfolge ersetzt; Lassen Sie leer, um die eingehende Abfragezeichenfolge beizubehalten. Die Abfragezeichenfolge muss <Schlüssel>=<Wert> Format aufweisen. Die erste ? und & werden automatisch hinzugefügt, sodass sie nicht in den Vordergrund eingeschlossen werden, sondern trennen Sie mehrere Abfragezeichenfolgen mit &.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DynamicCompression

Gibt an, ob die dynamische Komprimierung für zwischengespeicherte Inhalte verwendet werden soll.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EnableCaching

Erstellen Sie ein Speicherobjekt für RoutingRule.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EnabledState

Gibt an, ob die Verwendung dieser Regel aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled".

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ForwardingProtocol

Protokollieren Sie diese Regel, wenn Sie Datenverkehr an Back-Ends weiterleiten.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FrontDoorName

Der Name der Front door, zu der diese Routingregel gehört.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FrontendEndpointName

Front-End-Endpunkte, die dieser Regel zugeordnet sind.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Ressourcen-ID

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Ressourcenname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PatternsToMatch

Die Routenmuster der Regel.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PatternToMatch

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-QueryParameter

Abfrageparameter, die eingeschlossen oder ausgeschlossen werden sollen (durch Trennzeichen getrennt).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-QueryParameterStripDirective

Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RedirectProtocol

Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RedirectType

Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Ressourcengruppenname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RouteConfiguration

Erstellen Sie ein Speicherobjekt für RoutingRule.

Parametereigenschaften

Typ:IRouteConfiguration
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RuleEngineName

Ressourcen-ID

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:RulesEngineName

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WebApplicationFirewallPolicyLinkId

Ressourcen-ID

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

RoutingRule