Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
New-AzFrontDoorCdnRoute
- Module:
- Az.Cdn Module
Create a new route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
Syntax
CreateExpanded (Default)
New-AzFrontDoorCdnRoute
-Name <String>
-EndpointName <String>
-ProfileName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-CacheConfigurationQueryParameter <String>]
[-CacheConfigurationQueryStringCachingBehavior <String>]
[-CompressionSettingContentTypesToCompress <String[]>]
[-CompressionSettingIsCompressionEnabled]
[-CustomDomain <IActivatedResourceReference[]>]
[-EnabledState <String>]
[-ForwardingProtocol <String>]
[-HttpsRedirect <String>]
[-LinkToDefaultDomain <String>]
[-OriginGroupId <String>]
[-OriginPath <String>]
[-PatternsToMatch <String[]>]
[-RuleSet <IResourceReference[]>]
[-SupportedProtocol <String[]>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityProfile
New-AzFrontDoorCdnRoute
-Name <String>
-EndpointName <String>
-ProfileInputObject <ICdnIdentity>
-Route <IRoute>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityProfileExpanded
New-AzFrontDoorCdnRoute
-Name <String>
-EndpointName <String>
-ProfileInputObject <ICdnIdentity>
[-CacheConfigurationQueryParameter <String>]
[-CacheConfigurationQueryStringCachingBehavior <String>]
[-CompressionSettingContentTypesToCompress <String[]>]
[-CompressionSettingIsCompressionEnabled]
[-CustomDomain <IActivatedResourceReference[]>]
[-EnabledState <String>]
[-ForwardingProtocol <String>]
[-HttpsRedirect <String>]
[-LinkToDefaultDomain <String>]
[-OriginGroupId <String>]
[-OriginPath <String>]
[-PatternsToMatch <String[]>]
[-RuleSet <IResourceReference[]>]
[-SupportedProtocol <String[]>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonFilePath
New-AzFrontDoorCdnRoute
-Name <String>
-EndpointName <String>
-ProfileName <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonString
New-AzFrontDoorCdnRoute
-Name <String>
-EndpointName <String>
-ProfileName <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityAfdEndpoint
New-AzFrontDoorCdnRoute
-Name <String>
-AfdEndpointInputObject <ICdnIdentity>
-Route <IRoute>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityAfdEndpointExpanded
New-AzFrontDoorCdnRoute
-Name <String>
-AfdEndpointInputObject <ICdnIdentity>
[-CacheConfigurationQueryParameter <String>]
[-CacheConfigurationQueryStringCachingBehavior <String>]
[-CompressionSettingContentTypesToCompress <String[]>]
[-CompressionSettingIsCompressionEnabled]
[-CustomDomain <IActivatedResourceReference[]>]
[-EnabledState <String>]
[-ForwardingProtocol <String>]
[-HttpsRedirect <String>]
[-LinkToDefaultDomain <String>]
[-OriginGroupId <String>]
[-OriginPath <String>]
[-PatternsToMatch <String[]>]
[-RuleSet <IResourceReference[]>]
[-SupportedProtocol <String[]>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Create a new route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
Examples
Example 1: Create an AzureFrontDoor route under the AzureFrontDoor profile
$originGroup = Get-AzFrontDoorCdnOriginGroup -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -OriginGroupName org001
$ruleSet = Get-AzFrontDoorCdnRuleSet -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -RuleSetName ruleset001
$customdomain = Get-AzFrontDoorCdnCustomDomain -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -CustomDomainName domain001
$ruleSetResoure = New-AzFrontDoorCdnResourceReferenceObject -Id $ruleSet.Id
$customdomainResoure = New-AzFrontDoorCdnResourceReferenceObject -Id $customdomain.Id
New-AzFrontDoorCdnRoute -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -EndpointName end001 -Name route001 -OriginGroupId $originGroup.Id -RuleSet @($ruleSetResoure) -PatternsToMatch "/*" -LinkToDefaultDomain "Enabled" -EnabledState "Enabled" -CustomDomain @($customdomainResoure)
Name ResourceGroupName
---- -----------------
route001 testps-rg-da16jm
Create an AzureFrontDoor route under the AzureFrontDoor profile
Parameters
-AfdEndpointInputObject
Identity Parameter
Parameter properties
| Type: | ICdnIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AsJob
Run the command as a job
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-CacheConfigurationQueryParameter
query parameters to include or exclude (comma separated).
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-CacheConfigurationQueryStringCachingBehavior
Defines how Frontdoor caches requests that include query strings. You can ignore any query strings when caching, ignore specific query strings, cache every request with a unique URL, or cache specific query strings.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-CompressionSettingContentTypesToCompress
List of content types on which compression applies. The value should be a valid MIME type.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-CompressionSettingIsCompressionEnabled
Indicates whether content compression is enabled on AzureFrontDoor. Default value is false. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on AzureFrontDoor when requested content is smaller than 1 byte or larger than 1 MB.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
-CustomDomain
Domains referenced by this endpoint.
Parameter properties
| Type: | |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-DefaultProfile
The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.
Parameter properties
| Type: | PSObject |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AzureRMContext, AzureCredential |
Parameter sets
-EnabledState
Whether to enable use of this rule. Permitted values are 'Enabled' or 'Disabled'
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EndpointName
Name of the endpoint under the profile which is unique globally.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ForwardingProtocol
Protocol this rule will use when forwarding traffic to backends.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-HttpsRedirect
Whether to automatically redirect HTTP traffic to HTTPS traffic. Note that this is a easy way to set up this rule and it will be the first rule that gets executed.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-JsonFilePath
Path of Json file supplied to the Create operation
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-JsonString
Json string supplied to the Create operation
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-LinkToDefaultDomain
whether this route will be linked to the default endpoint domain.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Name
Name of the routing rule.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | RouteName |
Parameter sets
-NoWait
Run the command asynchronously
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-OriginGroupId
Resource ID.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-OriginPath
A directory path on the origin that AzureFrontDoor can use to retrieve content from, e.g. contoso.cloudapp.net/originpath.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PatternsToMatch
The route patterns of the rule.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ProfileInputObject
Identity Parameter
Parameter properties
| Type: | ICdnIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ProfileName
Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ResourceGroupName
Name of the Resource group within the Azure subscription.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Route
Friendly Routes name mapping to the any Routes or secret related information.
Parameter properties
| Type: | IRoute |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RuleSet
rule sets referenced by this endpoint.
Parameter properties
| Type: | |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SubscriptionId
Azure Subscription ID.
Parameter properties
| Type: | String |
| Default value: | (Get-AzContext).Subscription.Id |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SupportedProtocol
List of supported protocols for this route.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
ICdnIdentity
IRoute
Outputs
IRoute
Azure PowerShell
Feedback
Was this page helpful?