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: ID を使用して 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
ID を使用して 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 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ContentTypesToCompress
圧縮が適用されるコンテンツ タイプの一覧。 値は有効な MIME の種類である必要があります。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultOriginGroupId
リソース ID。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。
型: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeliveryPolicyDescription
ポリシーのわかりやすい説明。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeliveryPolicyRule
配信ルールの一覧。 構築するには、DELIVERYPOLICYRULE プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
型: | IDeliveryRule[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GeoFilter
CDN エンドポイント内でユーザーの geo アクセスを定義するルールの一覧。 各 geo フィルターは、指定されたパスまたはコンテンツへのアクセス規則を定義します。たとえば、パス /pictures/ を構築するための APAC のブロックは、GEOFILTER プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
型: | IGeoFilter[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
ID パラメーターを構築するには、INPUTOBJECT プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
型: | ICdnIdentity |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-IsCompressionEnabled
CDN でコンテンツ圧縮が有効になっているかどうかを示します。 既定値は false です。 圧縮が有効になっている場合、ユーザーが圧縮バージョンを要求した場合、コンテンツは圧縮として処理されます。 要求されたコンテンツが 1 バイト未満または 1 MB より大きい場合、CDN ではコンテンツは圧縮されません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IsHttpAllowed
エンドポイントで HTTP トラフィックが許可されているかどうかを示します。 既定値は true です。 少なくとも 1 つのプロトコル (HTTP または HTTPS) を許可する必要があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IsHttpsAllowed
エンドポイントで HTTPS トラフィックが許可されているかどうかを示します。 既定値は true です。 少なくとも 1 つのプロトコル (HTTP または HTTPS) を許可する必要があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
グローバルに一意であるプロファイルの下のエンドポイントの名前。
型: | String |
Aliases: | EndpointName |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoWait
コマンドを非同期的に実行する
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OptimizationType
お客様がこの CDN エンドポイントを最適化するシナリオ (ダウンロード、メディア サービスなど) を指定します。 この情報を使用すると、CDN はシナリオ駆動型の最適化を適用できます。
型: | OptimizationType |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OriginHostHeader
各要求で配信元に送信されるホスト ヘッダー値。 エンドポイントでのこのプロパティは、エンドポイントが単一のオリジンを使用する場合にのみ許可され、配信元で指定されたのと同じプロパティによってオーバーライドできます。この値を空白のままにすると、要求ホスト名によってこの値が決まります。 Web Apps、Blob Storage、Cloud Services などの Azure CDN 配信元では、このホスト ヘッダー値が既定で配信元のホスト名と一致する必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OriginPath
CDN がコンテンツの取得に使用できる配信元のディレクトリ パス (例: contoso.cloudapp.net/originpath)。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ProbePath
配信元でホストされているファイルへのパス。動的コンテンツの配信を高速化し、CDN の最適なルートを計算するのに役立ちます。 これは原点パスに対する相対パスです。 このプロパティは、単一のオリジンを使用する場合にのみ関連します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ProfileName
リソース グループ内で一意である CDN プロファイルの名前。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-QueryStringCachingBehavior
クエリ文字列を含む要求を CDN がキャッシュする方法を定義します。 キャッシュ時にクエリ文字列を無視したり、キャッシュをバイパスしてクエリ文字列を含む要求がキャッシュされないようにしたり、一意の URL ですべての要求をキャッシュしたりできます。
型: | QueryStringCachingBehavior |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
Azure サブスクリプション内のリソース グループの名前。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SubscriptionId
Azure サブスクリプション ID。
型: | String |
配置: | Named |
規定値: | (Get-AzContext).Subscription.Id |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Tag
エンドポイント タグ。
型: | Hashtable |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UrlSigningKey
署名された URL ハッシュの検証に使用されるキーの一覧。 構築するには、URLSIGNINGKEY プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
型: | IUrlSigningKey[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WebApplicationFirewallPolicyLinkId
リソース ID。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
Azure PowerShell