New-AzFrontDoorCdnRoute

參考

模組:: Az.Cdn

在指定的訂用帳戶、資源群組、配置檔和 AzureFrontDoor 端點下，建立具有指定路由名稱的新路由。

語法

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

Description

在指定的訂用帳戶、資源群組、配置檔和 AzureFrontDoor 端點下，建立具有指定路由名稱的新路由。

範例

範例 1：在 AzureFrontDoor 配置檔下建立 AzureFrontDoor 路由

$originGroup = Get-AzFrontDoorCdnOriginGroup -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -OriginGroupName org001
$ruleSet = Get-AzFrontDoorCdnRuleSet -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -RuleSetName ruleset001
$customdomain = Get-AzFrontDoorCdnCustomDomain -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -CustomDomainName domain001

$ruleSetResoure = New-AzFrontDoorCdnResourceReferenceObject -Id $ruleSet.Id
$customdomainResoure = New-AzFrontDoorCdnResourceReferenceObject -Id $customdomain.Id

New-AzFrontDoorCdnRoute -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -EndpointName end001 -Name route001 -OriginGroupId $originGroup.Id -RuleSet @($ruleSetResoure) -PatternsToMatch "/*" -LinkToDefaultDomain "Enabled" -EnabledState "Enabled" -CustomDomain @($customdomainResoure)

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

-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

資源標識碼。

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

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

輸出

IRoute

共用方式為