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

Update-AzCdnEndpoint

模块:

Az.Cdn

使用指定订阅、资源组和配置文件下的指定终结点名称更新现有 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

以作业身份运行命令

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

-Confirm

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

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

-ContentTypesToCompress

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

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

-DefaultOriginGroupId

资源 ID。

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

-DefaultProfile

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

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

-DeliveryPolicyDescription

策略的用户友好说明。

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

-DeliveryPolicyRule

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

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

-GeoFilter

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

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

-InputObject

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

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

-IsCompressionEnabled

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

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

-IsHttpAllowed

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

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

-IsHttpsAllowed

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

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

-Name

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

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

-NoWait

异步运行命令

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

-OptimizationType

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

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

-OriginHostHeader

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

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

-OriginPath

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

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

-ProbePath

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

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

-ProfileName

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

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

-QueryStringCachingBehavior

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

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

-ResourceGroupName

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

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

-SubscriptionId

Azure 订阅 ID。

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

-Tag

终结点标记。

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

-UrlSigningKey

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

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

-WebApplicationFirewallPolicyLinkId

资源 ID。

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

-WhatIf

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

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

输入

ICdnIdentity

输出

IEndpoint