New-AzureRmWebAppSSLBinding

  • リファレンス
モジュール:
AzureRM.Websites

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 アプリへのアクセスに使用される doメイン と一致している必要があります。
  • 証明書では、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 コマンドレットを使用します。 ResourceGroupName パラメーターまたは WebAppName パラメーターと同じコマンドで WebApp パラメーターを使用することはできません。

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

-WebAppName

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

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

入力

Site

パラメーター: WebApp (ByValue)

出力

HostNameSslState