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

Update-AzFrontDoorCdnRoute

使用指定的订阅、资源组、配置文件和 AzureFrontDoor 终结点下的指定路由名称更新现有路由。

语法

Update-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>]
Update-AzFrontDoorCdnRoute
      -InputObject <ICdnIdentity>
      [-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 路由

Update-AzFrontDoorCdnRoute -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -EndpointName end001 -Name route001 -EnabledState "Enabled"

Name     ResourceGroupName
----     -----------------
route001 testps-rg-da16jm

在 AzureFrontDoor 配置文件下更新 AzureFrontDoor 路由

示例 2:通过标识更新 AzureFrontDoor 配置文件下的 AzureFrontDoor 路由

Get-AzFrontDoorCdnRoute -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -EndpointName end001 -Name route001  | Update-AzFrontDoorCdnRoute -EnabledState "Enabled"

Name     ResourceGroupName
----     -----------------
route001 testps-rg-da16jm

通过标识在 AzureFrontDoor 配置文件下更新 AzureFrontDoor 路由

示例 3:在 AzureFrontDoor 配置文件下更新 AzureFrontDoor 路由,启用内容压缩

Update-AzFrontDoorCdnRoute -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -EndpointName end001 -Name route001 -CompressionSettingIsCompressionEnabled:true

Name     ResourceGroupName
----     -----------------
route001 testps-rg-da16jm

在 AzureFrontDoor 配置文件下更新 AzureFrontDoor 路由,启用内容压缩

参数

-AsJob

以作业身份运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CacheConfigurationQueryParameter

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CacheConfigurationQueryStringCachingBehavior

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

类型:AfdQueryStringCachingBehavior
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CompressionSettingContentTypesToCompress

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

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CompressionSettingIsCompressionEnabled

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CustomDomain

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

类型:IActivatedResourceReference[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:PSObject
别名:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnabledState

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

类型:EnabledState
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EndpointName

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

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ForwardingProtocol

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

类型:ForwardingProtocol
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HttpsRedirect

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

类型:HttpsRedirect
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

要构造的标识参数,请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

类型:ICdnIdentity
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-LinkToDefaultDomain

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

类型:LinkToDefaultDomain
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

路由规则的名称。

类型:String
别名:RouteName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NoWait

异步运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OriginGroupId

资源 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OriginPath

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PatternsToMatch

规则的路由模式。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ProfileName

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

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ResourceGroupName

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

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RuleSet

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

类型:IResourceReference[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SubscriptionId

Azure 订阅 ID。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-SupportedProtocol

此路由支持的协议列表。

类型:AfdEndpointProtocols[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

ICdnIdentity

输出

IRoute