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

New-AzCdnEndpoint

  • 参考
模块:
Az.Cdn

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

语法

New-AzCdnEndpoint
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-ContentTypesToCompress <String[]>]
   [-DefaultOriginGroupId <String>]
   [-DeliveryPolicyDescription <String>]
   [-DeliveryPolicyRule <IDeliveryRule[]>]
   [-GeoFilter <IGeoFilter[]>]
   [-IsCompressionEnabled]
   [-IsHttpAllowed]
   [-IsHttpsAllowed]
   [-OptimizationType <OptimizationType>]
   [-Origin <IDeepCreatedOrigin[]>]
   [-OriginGroup <IDeepCreatedOriginGroup[]>]
   [-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 终结点

$origin = @{
    Name = "origin1"
    HostName = "host1.hello.com"
};
New-AzCdnEndpoint -ResourceGroupName testps-rg-da16jm -ProfileName cdn001 -Name endptest001 -Location westus -Origin $origin

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

-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

-Location

资源位置。

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

-Origin

通过 CDN 传递的内容源。 若要构造，请参阅 ORIGIN 属性的 NOTES 部分并创建哈希表。

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

-OriginGroup

源组由用于基于可用性对流量进行负载均衡的源组。 若要构造，请参阅 ORIGINGROUP 属性的 NOTES 部分并创建哈希表。

Type:IDeepCreatedOriginGroup[]
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

输出

IEndpoint