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 アプリへのアクセスに使用される doメイン と一致している必要があります。
- 証明書では、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 にアップロードされていない場合にのみ必要です。
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CertificatePassword
証明書の暗号化解除パスワードを指定します。
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Web アプリの名前を指定します。
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
証明書が割り当てられているリソース グループの名前を指定します。 同じコマンドで ResourceGroupName パラメーターと WebApp パラメーターを使用することはできません。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Slot
Web アプリデプロイ スロットの名前を指定します。 Get-AzWebAppSlot コマンドレットを使用してスロットを取得できます。 デプロイ スロットを使用すると、インターネット経由でこれらのアプリにアクセスすることなく、Web アプリをステージングおよび検証できます。 通常は、変更をステージング サイトに展開し、それらの変更を検証してから、運用環境 (インターネットにアクセス可能) サイトに展開します。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SslState
証明書が有効かどうかを指定します。 証明書を有効にするには SSLState パラメーターを 1 に設定し、証明書を無効にするには SSLState を 0 に設定します。
| Type: | Nullable<T>[SslState] |
| Accepted values: | Disabled, SniEnabled, IpBasedEnabled |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Thumbprint
証明書の一意識別子を指定します。
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WebApp
Web アプリを指定します。 Web アプリを取得するには、Get-AzWebApp コマンドレットを使用します。 ResourceGroupName パラメーターまたは WebAppName パラメーターと同じコマンドで WebApp パラメーターを使用することはできません。
| Type: | PSSite |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WebAppName
新しい SSL バインドを作成する Web アプリの名前を指定します。 同じコマンドで WebAppName パラメーターと WebApp パラメーターを使用することはできません。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |