New-AzApiManagementGatewayHostnameConfiguration

リファレンス

モジュール:: Az.ApiManagement

既存のゲートウェイのホスト名構成を作成します。

構文

New-AzApiManagementGatewayHostnameConfiguration
   -Context <PsApiManagementContext>
   -GatewayId <String>
   [-GatewayHostnameConfigurationId <String>]
   -Hostname <String>
   -CertificateResourceId <String>
   [-NegotiateClientCertificate]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzApiManagementGatewayHostnameConfiguration コマンドレットは、既存のゲートウェイのホスト名構成を作成します。

例

例 1: 既存のゲートウェイのホスト名構成を作成する

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
$cert = Get-AzApiManagementCertificate -Context $apimContext -CertificateId "333"
New-AzApiManagementGatewayHostnameConfiguration -Context $apimContext -GatewayId "g01" -GatewayHostnameConfigurationId "h01" -Hostname "www.contoso.com" -CertificateResourceId $cert.Id

このコマンドは、"g01" ゲートウェイの "h01" ホスト名構成を作成します。

パラメーター

-CertificateResourceId

既存の証明書 ID のリソース識別子。このパラメーターは必須です。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Context

PsApiManagementContext のインスタンス。このパラメーターは必須です。

型:	PsApiManagementContext
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GatewayHostnameConfigurationId

新しいゲートウェイホスト名の構成の識別子。このパラメーターは省略可能です。指定しない場合は生成されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-GatewayId

既存のゲートウェイの識別子。このパラメーターは必須です。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Hostname

ホスト名。このパラメーターは必須です。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-NegotiateClientCertificate

NegotiateClientCertificate を適用するフラグ。このパラメーターは省略可能です。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False