Dela via


New-AzFrontDoorRoutingRuleObject

Skapa en PSRoutingRuleObject för att skapa Front Door

Syntax

New-AzFrontDoorRoutingRuleObject
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -Name <String>
   -FrontendEndpointName <String[]>
   -BackendPoolName <String>
   [-AcceptedProtocol <PSProtocol[]>]
   [-PatternToMatch <String[]>]
   [-CustomForwardingPath <String>]
   [-ForwardingProtocol <String>]
   [-EnableCaching <Boolean>]
   [-QueryParameterStripDirective <String>]
   [-DynamicCompression <PSEnabledState>]
   [-EnabledState <PSEnabledState>]
   [-RulesEngineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzFrontDoorRoutingRuleObject
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -Name <String>
   -FrontendEndpointName <String[]>
   [-AcceptedProtocol <PSProtocol[]>]
   [-PatternToMatch <String[]>]
   [-RedirectType <String>]
   [-RedirectProtocol <String>]
   [-CustomHost <String>]
   [-CustomPath <String>]
   [-CustomFragment <String>]
   [-CustomQueryString <String>]
   [-EnabledState <PSEnabledState>]
   [-RulesEngineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Skapa en PSRoutingRuleObject för att skapa Front Door

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"

FrontendEndpointIds          : {/subscriptions/{subid}/resourceGroups/{rgname}/pro
                               viders/Microsoft.Network/frontDoors/{frontdoorname}/FrontendEndpoints/frontendEndpoint1}
AcceptedProtocols            : {Http, Https}
PatternsToMatch              : {/*}
HealthProbeSettings          :
RouteConfiguration           : Microsoft.Azure.Commands.FrontDoor.Models.PSForwardingConfiguration
EnabledState                 : Enabled
ResourceState                :
Id                           :
Name                         : {routingRuleName}
Type                         :

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

FrontendEndpointIds          : {/subscriptions/{subid}/resourceGroups/{rgname}/pro
                               viders/Microsoft.Network/frontDoors/{frontdoorname}/FrontendEndpoints/frontendEndpoint1}
AcceptedProtocols            : {Http, Https}
PatternsToMatch              : {/*}
HealthProbeSettings          :
RouteConfiguration           : Microsoft.Azure.Commands.FrontDoor.Models.PSRedirectConfiguration
EnabledState                 : Enabled
ResourceState                :
Id                           :
Name                         : {routingRuleName}
Type                         :

Skapa en PSRoutingRuleObject för att skapa Front Door

Parametrar

-AcceptedProtocol

Protokollscheman som matchar för den här regeln. Standardvärdet är {Https, Http}

Type:PSProtocol[]
Accepted values:Http, Https
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendPoolName

Resurs-ID för backendPool som den här regeln dirigerar till

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

-CustomForwardingPath

Den anpassade 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 #.

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

-CustomHost

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 <key>=<value> format. Den första? och & kommer att läggas till automatiskt så ta inte med dem längst fram, men separera flera frågesträngar med &.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DynamicCompression

Om du vill aktivera dynamisk komprimering för cachelagrat innehåll när cachelagring är aktiverat. Standardvärdet är aktiverat

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

-EnableCaching

Om du vill aktivera cachelagring för den här vägen. Standardvärdet är falskt

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

-EnabledState

Om du vill aktivera användning av den här regeln. Standardvärdet är aktiverat

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

-ForwardingProtocol

Det protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelens standardvärde är MatchRequest.

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

-FrontDoorName

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

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

-FrontendEndpointName

Namnen på klientdelsslutpunkter som är associerade med den här regeln

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

-Name

RoutingRule-namn.

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

-PatternToMatch

Vägmönster för regeln, Får inte ha någon * förutom eventuellt efter den sista / i slutet av sökvägen. Standardvärdet är /*

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

-QueryParameterStripDirective

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

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

-RedirectProtocol

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

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

-RedirectType

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

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

-ResourceGroupName

Resursgruppens namn som RoutingRule skapas i.

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

-RulesEngineName

En referens till en specifik regelmotorkonfiguration som ska tillämpas på den här vägen.

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

Indata

None

Utdata

PSRoutingRule