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 |
入力
出力
関連リンク
Azure PowerShell