次の方法で共有


New-AzWebAppSSLBinding

Azure Web アプリの SSL 証明書バインドを作成します。

構文

New-AzWebAppSSLBinding
   [-ResourceGroupName] <String>
   [-WebAppName] <String>
   [[-Slot] <String>]
   [-Name] <String>
   [[-SslState] <SslState>]
   [-CertificateFilePath] <String>
   [-CertificatePassword] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzWebAppSSLBinding
   [-ResourceGroupName] <String>
   [-WebAppName] <String>
   [[-Slot] <String>]
   [-Name] <String>
   [[-SslState] <SslState>]
   [-Thumbprint] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzWebAppSSLBinding
   [-WebApp] <PSSite>
   [-Name] <String>
   [[-SslState] <SslState>]
   [-CertificateFilePath] <String>
   [-CertificatePassword] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzWebAppSSLBinding
   [-WebApp] <PSSite>
   [-Name] <String>
   [[-SslState] <SslState>]
   [-Thumbprint] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzWebAppSSLBinding コマンドレットは、Azure Web アプリの Secure Socket Layer (SSL) 証明書バインドを作成します。 このコマンドレットは、次の 2 つの方法で SSL バインディングを作成します。

  • Web アプリを既存の証明書にバインドできます。
  • 新しい証明書をアップロードし、Web アプリをこの新しい証明書にバインドできます。 使用する方法に関係なく、証明書と Web アプリを同じ Azure リソース グループに関連付ける必要があります。 リソース グループ A に Web アプリがあり、その Web アプリをリソース グループ B の証明書にバインドする場合は、証明書のコピーをリソース グループ A にアップロードするしかありません。新しい証明書をアップロードする場合は、Azure SSL 証明書の次の要件に注意してください。
  • 証明書は秘密キーを含む必要があります。
  • 証明書は、Personal Information Exchange (PFX) 形式を使用する必要があります。
  • 証明書のサブジェクト名は、Web アプリへのアクセスに使用されるドメインと一致する必要があります。
  • 証明書では、2048 ビット以上の暗号化を使用する必要があります。

例 1: 証明書を Web アプリにバインドする

New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"

このコマンドは、既存の Azure 証明書 (拇印E3A38EBA60CAA1C162785A2E1C44A15AD450199C3を持つ証明書) を ContosoWebApp という名前の Web アプリにバインドします。

例 2

Azure Web アプリの SSL 証明書バインドを作成します。 (自動生成)

New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'

例 3

Azure Web アプリの SSL 証明書バインドを作成します。 (自動生成)

New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'

パラメーター

-CertificateFilePath

アップロードする証明書のファイル パスを指定します。 CertificateFilePath パラメーターは、証明書がまだ Azure にアップロードされていない場合にのみ必要です。

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

-CertificatePassword

証明書の暗号化解除パスワードを指定します。

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

-Confirm

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

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

-DefaultProfile

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

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

-Name

Web アプリの名前を指定します。

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

-ResourceGroupName

証明書が割り当てられているリソース グループの名前を指定します。 同じコマンドで ResourceGroupName パラメーターと WebApp パラメーターを使用することはできません。

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

-Slot

Web アプリデプロイ スロットの名前を指定します。 Get-AzWebAppSlot コマンドレットを使用してスロットを取得できます。 デプロイ スロットを使用すると、インターネット経由でこれらのアプリにアクセスすることなく、Web アプリをステージングおよび検証できます。 通常は、変更をステージング サイトに展開し、それらの変更を検証してから、運用環境 (インターネットにアクセス可能) サイトに展開します。

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

-SslState

証明書が有効かどうかを指定します。 証明書を有効にするには SSLState パラメーターを 1 に設定し、証明書を無効にするには SSLState を 0 に設定します。

型:Nullable<T>[SslState]
指定可能な値:Disabled, SniEnabled, IpBasedEnabled
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Thumbprint

証明書の一意識別子を指定します。

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

-WebApp

Web アプリを指定します。 Web アプリを取得するには、Get-AzWebApp コマンドレットを使用します。 WebApp パラメーターは、ResourceGroupName パラメーターや WebAppName と同じコマンドでは使用できません。

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

-WebAppName

新しい SSL バインドを作成する Web アプリの名前を指定します。 同じコマンドで WebAppName パラメーターと WebApp パラメーターを使用することはできません。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

PSSite

出力

HostNameSslState