你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzFrontDoorCdnRoute

在指定的订阅、资源组、配置文件和 AzureFrontDoor 终结点下创建具有指定路由名称的新路由。

语法

New-AzFrontDoorCdnRoute
   -EndpointName <String>
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-CacheConfigurationQueryParameter <String>]
   [-CacheConfigurationQueryStringCachingBehavior <AfdQueryStringCachingBehavior>]
   [-CompressionSettingContentTypesToCompress <String[]>]
   [-CompressionSettingIsCompressionEnabled]
   [-CustomDomain <IActivatedResourceReference[]>]
   [-EnabledState <EnabledState>]
   [-ForwardingProtocol <ForwardingProtocol>]
   [-HttpsRedirect <HttpsRedirect>]
   [-LinkToDefaultDomain <LinkToDefaultDomain>]
   [-OriginGroupId <String>]
   [-OriginPath <String>]
   [-PatternsToMatch <String[]>]
   [-RuleSet <IResourceReference[]>]
   [-SupportedProtocol <AfdEndpointProtocols[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

在指定的订阅、资源组、配置文件和 AzureFrontDoor 终结点下创建具有指定路由名称的新路由。

示例

示例 1:在 AzureFrontDoor 配置文件下创建 AzureFrontDoor 路由

$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

在 AzureFrontDoor 配置文件下创建 AzureFrontDoor 路由

参数

-AsJob

以作业身份运行命令

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

-CacheConfigurationQueryParameter

要包含或排除的查询参数(逗号分隔)。

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

-CacheConfigurationQueryStringCachingBehavior

定义 Frontdoor 如何缓存包含查询字符串的请求。 缓存、忽略特定查询字符串、使用唯一 URL 缓存每个请求或缓存特定查询字符串时,可以忽略任何查询字符串。

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

-CompressionSettingContentTypesToCompress

要对其应用压缩的内容类型的列表。 该值应为有效的 MIME 类型。

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

-CompressionSettingIsCompressionEnabled

指示是否在 AzureFrontDoor 上启用内容压缩。 默认值为 false。 如果启用了压缩,则如果用户请求压缩版本,内容将作为压缩。 当请求的内容小于 1 字节或大于 1 MB 时,不会在 AzureFrontDoor 上压缩内容。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomDomain

此终结点引用的域。 若要构造,请参阅 CUSTOMDOMAIN 属性的 NOTES 部分并创建哈希表。

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

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnabledState

是否要启用此规则。 允许的值为“Enabled”或“Disabled”

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

-EndpointName

全局唯一的配置文件下的终结点的名称。

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

-ForwardingProtocol

将流量转发到后端时此规则将使用的协议。

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

-HttpsRedirect

是否自动将 HTTP 流量重定向到 HTTPS 流量。 请注意,这是设置此规则的一种简单方法,这将是执行的第一个规则。

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

-LinkToDefaultDomain

此路由是否将链接到默认终结点域。

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

-Name

路由规则的名称。

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

-NoWait

异步运行命令

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

-OriginGroupId

资源 ID。

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

-OriginPath

AzureFrontDoor 可用于从源检索内容的目录路径,例如 contoso.cloudapp.net/originpath。

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

-PatternsToMatch

规则的路由模式。

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

-ProfileName

Azure Front Door Standard 或 Azure Front Door 高级版配置文件的名称,该配置文件在资源组中是唯一的。

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

-ResourceGroupName

Azure 订阅中的资源组的名称。

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

-RuleSet

此终结点引用的规则集。 若要构造,请参阅 RULE标准版T 属性的 NOTES 部分并创建哈希表。

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

-SubscriptionId

Azure 订阅 ID。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SupportedProtocol

此路由支持的协议列表。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输出

IRoute