New-AzureRmWebAppSSLBinding
Azure Web アプリの SSL 証明書バインドを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
New-AzureRmWebAppSSLBinding コマンドレットは、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 アプリにバインドする
PS C:\>New-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"このコマンドは、既存の Azure 証明書 (拇印E3A38EBA60CAA1C162785A2E1C44A15AD450199C3を持つ証明書) を ContosoWebApp という名前の Web アプリにバインドします。
パラメーター
-CertificateFilePath
アップロードする証明書のファイル パスを指定します。 CertificateFilePath パラメーターは、証明書がまだ Azure にアップロードされていない場合にのみ必要です。
| 型: | String |
| 配置: | 4 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CertificatePassword
証明書の暗号化解除パスワードを指定します。
| 型: | String |
| 配置: | 5 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| 型: | IAzureContextContainer |
| Aliases: | 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-AzureRMWebAppSlot コマンドレットを使用してスロットを取得できます。 デプロイ スロットを使用すると、インターネット経由でこれらのアプリにアクセスすることなく、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-AzureRmWebApp コマンドレットを使用します。 WebApp パラメーターは、ResourceGroupName パラメーターや WebAppName と同じコマンドでは使用できません。
| 型: | PSSite |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WebAppName
新しい SSL バインドを作成する Web アプリの名前を指定します。 同じコマンドで WebAppName パラメーターと WebApp パラメーターを使用することはできません。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
パラメーター: WebApp (ByValue)