Update-AzCdnEndpoint

模組:

Az.Cdn

使用指定的訂用帳戶、資源群組和配置檔底下的指定端點名稱，更新現有的 CDN 端點。 建立端點之後，只能更新標記。 若要更新原始來源，請使用Update Origin作業。 若要更新原始群組，請使用更新來源群組作業。 若要更新自定義網域，請使用更新自定義網域作業。

語法

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>]

Description

使用指定的訂用帳戶、資源群組和配置檔底下的指定端點名稱，更新現有的 CDN 端點。 建立端點之後，只能更新標記。 若要更新原始來源，請使用Update Origin作業。 若要更新原始群組，請使用更新來源群組作業。 若要更新自定義網域，請使用更新自定義網域作業。

範例

範例 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

資源標識碼。

類型:	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/ To construct 的 APAC，請參閱 GEOFILTER 屬性的 NOTES 區段並建立哈希表。

類型:	IGeoFilter[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

Identity Parameter To construct， see NOTES section for INPUTOBJECT properties and create a hash table.

類型:	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 Apps、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 訂用帳戶標識碼。

類型:	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

資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

ICdnIdentity

輸出

IEndpoint