New-AzFrontDoorRoutingRuleObject

Modul:
Az.FrontDoor Module

Skapa ett minnesinternt objekt 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>]

Description

Skapa ett minnesinternt objekt för RoutingRule.

Exempel

Exempel 1: Skapa en PSRoutingRuleObject för att skapa Front Door med en vidarebefordringsregel

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 :

Skapa en PSRoutingRuleObject för att skapa Front Door med en vidarebefordringsregel

Exempel 2: Skapa en PSRoutingRuleObject för att skapa Front Door med en omdirigeringsregel

$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 :

Skapa en PSRoutingRuleObject för att skapa Front Door

Parametrar

-AcceptedProtocol

Protokollscheman som matchar för den här regeln.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-BackendPoolName

Resurs-ID.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CacheDuration

Hur länge innehållet måste cachelagras. Det tillåtna formatet är i ISO 8601-format (). HTTP kräver att värdet inte är längre än ett år.

Parameteregenskaper

Typ:TimeSpan
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CustomForwardingPath

En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Låt vara tom om du vill använda inkommande sökväg.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CustomFragment

Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Ta inte med #.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CustomHost

Värd för omdirigering. Låt vara tom om du vill använda den inkommande värden som målvärd.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CustomPath

Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tom om du vill använda den inkommande sökvägen som målsökväg.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CustomQueryString

Den uppsättning frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tom för att bevara den inkommande frågesträngen. Frågesträngen måste vara i nyckel=värde format. Den första? och & läggs till automatiskt så ta inte med dem i fronten, men separera flera frågesträngar med &.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DynamicCompression

Om dynamisk komprimering ska användas för cachelagrat innehåll.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EnableCaching

Skapa ett minnesinternt objekt för RoutingRule.

Parameteregenskaper

Typ:Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EnabledState

Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade".

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ForwardingProtocol

Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FrontDoorName

Namnet på den Front Door som den här routningsregeln tillhör.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FrontendEndpointName

Klientdelsslutpunkter som är associerade med den här regeln.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

Resurs-ID.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Resursnamn.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PatternsToMatch

Regelns vägmönster.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PatternToMatch

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-QueryParameter

frågeparametrar som ska inkluderas eller exkluderas (kommaavgränsade).

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-QueryParameterStripDirective

Behandling av URL-frågetermer när du bildar cachenyckeln.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithForwardingParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RedirectProtocol

Protokollet för målet till där trafiken omdirigeras.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RedirectType

Omdirigeringstypen som regeln ska använda vid omdirigering av trafik.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByFieldsWithRedirectParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceGroupName

Resursgruppsnamn.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RouteConfiguration

Skapa ett minnesinternt objekt för RoutingRule.

Parameteregenskaper

Typ:IRouteConfiguration
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RuleEngineName

Resurs-ID.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:RulesEngineName

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WebApplicationFirewallPolicyLinkId

Resurs-ID.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Utdata

RoutingRule