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

Update-AzCdnEndpoint

汇报具有指定订阅、资源组和配置文件下指定终结点名称的现有 CDN 终结点。 创建终结点后只能更新标记。 若要更新源,请使用“更新源”操作。 若要更新源组,请使用“更新源”组操作。 若要更新自定义域,请使用“更新自定义域”操作。

语法

Update-AzCdnEndpoint
      -Name <String>
      -ProfileName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-ContentTypesToCompress <String[]>]
      [-DefaultOriginGroupId <String>]
      [-DeliveryPolicyDescription <String>]
      [-DeliveryPolicyRule <IDeliveryRule[]>]
      [-GeoFilter <IGeoFilter[]>]
      [-IsCompressionEnabled]
      [-IsHttpAllowed]
      [-IsHttpsAllowed]
      [-OptimizationType <OptimizationType>]
      [-OriginHostHeader <String>]
      [-OriginPath <String>]
      [-ProbePath <String>]
      [-QueryStringCachingBehavior <QueryStringCachingBehavior>]
      [-Tag <Hashtable>]
      [-UrlSigningKey <IUrlSigningKey[]>]
      [-WebApplicationFirewallPolicyLinkId <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzCdnEndpoint
      -InputObject <ICdnIdentity>
      [-ContentTypesToCompress <String[]>]
      [-DefaultOriginGroupId <String>]
      [-DeliveryPolicyDescription <String>]
      [-DeliveryPolicyRule <IDeliveryRule[]>]
      [-GeoFilter <IGeoFilter[]>]
      [-IsCompressionEnabled]
      [-IsHttpAllowed]
      [-IsHttpsAllowed]
      [-OptimizationType <OptimizationType>]
      [-OriginHostHeader <String>]
      [-OriginPath <String>]
      [-ProbePath <String>]
      [-QueryStringCachingBehavior <QueryStringCachingBehavior>]
      [-Tag <Hashtable>]
      [-UrlSigningKey <IUrlSigningKey[]>]
      [-WebApplicationFirewallPolicyLinkId <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

汇报具有指定订阅、资源组和配置文件下指定终结点名称的现有 CDN 终结点。 创建终结点后只能更新标记。 若要更新源,请使用“更新源”操作。 若要更新源组,请使用“更新源”组操作。 若要更新自定义域,请使用“更新自定义域”操作。

示例

示例 1:在 AzureCDN 配置文件下更新 AzureCDN 终结点

$tags = @{
    Tag1 = 11
    Tag2 = 22
}
Update-AzCdnEndpoint -ResourceGroupName testps-rg-da16jm -ProfileName cdn001 -Name endptest001 -Tag $tags -DefaultOriginGroupId $originGroup.Id

Location Name        ResourceGroupName
-------- ----        -----------------
WestUs   endptest001 testps-rg-da16jm

在 AzureCDN 配置文件下更新 AzureCDN 终结点

示例 2:通过标识更新 AzureCDN 配置文件下的 AzureCDN 终结点

$tags = @{
    Tag1 = 11
    Tag2 = 22
}
Get-AzCdnEndpoint -ResourceGroupName testps-rg-da16jm -ProfileName cdn001 -Name endptest001 | Update-AzCdnEndpoint -Tag $tags -DefaultOriginGroupId $originGroup.Id

Location Name        ResourceGroupName
-------- ----        -----------------
WestUs   endptest001 testps-rg-da16jm

通过标识更新 AzureCDN 配置文件下的 AzureCDN 终结点

示例 3:在 AzureCDN 配置文件下更新 AzureCDN 终结点,启用内容压缩

Update-AzCdnEndpoint -Name cdntestcert -ProfileName classicCDNtest -ResourceGroupName yaoshitest -IsCompressionEnabled:$true

Location Name        ResourceGroupName
-------- ----        -----------------
WestUs   endptest001 testps-rg-da16jm

更新 AzureCDN 配置文件下的 AzureCDN 终结点,启用内容压缩

参数

-AsJob

以作业身份运行命令

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

-ContentTypesToCompress

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

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

-DefaultOriginGroupId

资源 ID。

Type:String
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

-DeliveryPolicyDescription

策略的用户友好说明。

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

-DeliveryPolicyRule

传递规则的列表。 若要构造,请参阅 DELIVERYPOLICYRULE 属性的 NOTES 部分,并创建哈希表。

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

-GeoFilter

定义 CDN 终结点中用户异地访问的规则列表。 每个地理筛选器定义对指定路径或内容的访问规则,例如用于路径 /pictures 的块 APAC/若要构造,请参阅 GEOFILTER 属性的 NOTES 部分并创建哈希表。

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

-InputObject

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

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

-IsCompressionEnabled

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

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

-IsHttpAllowed

指示是否允许终结点上的 HTTP 流量。 默认值为 true。 必须至少允许一个协议(HTTP 或 HTTPS)。

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

-IsHttpsAllowed

指示是否允许终结点上的 HTTPS 流量。 默认值为 true。 必须至少允许一个协议(HTTP 或 HTTPS)。

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

-Name

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

Type:String
Aliases:EndpointName
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

-OptimizationType

指定客户希望此 CDN 终结点针对哪些方案进行优化,例如下载媒体服务。 利用此信息,CDN 可以应用方案驱动的优化。

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

-OriginHostHeader

随每个请求发送到源的主机标头值。 仅当终结点使用单一源并且可由源中指定的同一属性重写时,才允许终结点中的此属性。如果将此保留为空,则请求主机名将确定此值。 Azure CDN 源(例如 Web 应用、Blob 存储和云服务)默认要求此主机头值与源主机名匹配。

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

-OriginPath

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

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

-ProbePath

源上托管的文件的路径,有助于加速动态内容的交付,并计算 CDN 的最佳路由。 这与源路径相对。 此属性仅在使用单个源时相关。

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

-ProfileName

资源组中唯一的 CDN 配置文件的名称。

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

-QueryStringCachingBehavior

定义 CDN 如何缓存包含查询字符串的请求。 缓存时,可以忽略任何查询字符串,绕过缓存,以防止包含查询字符串的请求被缓存,或缓存每个请求的唯一 URL。

Type:QueryStringCachingBehavior
Position:Named
Default value:None
Required:False
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

-SubscriptionId

Azure 订阅 ID。

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

-Tag

终结点标记。

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

-UrlSigningKey

用于验证已签名 URL 哈希的密钥列表。 若要构造,请参阅 URLSIGNINGKEY 属性的 NOTES 部分,并创建哈希表。

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

-WebApplicationFirewallPolicyLinkId

资源 ID。

Type:String
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

输入

ICdnIdentity

输出

IEndpoint