你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzWebAppSSLBinding

参考

模块:: Az.Websites

为 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 cmdlet 为 Azure Web 应用创建安全套接字层（SSL）证书绑定。该 cmdlet 通过两种方式创建 SSL 绑定：

可以将 Web 应用绑定到现有证书。
可以上传新证书，然后将 Web 应用绑定到此新证书。无论使用哪种方法，证书和 Web 应用都必须与同一 Azure 资源组相关联。如果资源组 A 中有 Web 应用，并且想要将该 Web 应用绑定到资源组 B 中的证书，唯一的方法是将证书的副本上传到资源组 A。如果上传新证书，请记住 Azure SSL 证书的以下要求：
证书必须包含私钥。
证书必须使用个人信息交换（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'

powershell

示例 3

为 Azure Web 应用创建 SSL 证书绑定。（自动生成）

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

参数

-CertificateFilePath

指定要上传的证书的文件路径。仅当证书尚未上传到 Azure 时，才需要 CertificateFilePath 参数。

类型:	String
Position:	4
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-CertificatePassword

指定证书的解密密码。

类型:	String
Position:	5
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定 Web 应用的名称。

类型:	String
Position:	3
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

指定证书分配给的资源组的名称。不能在同一命令中使用 ResourceGroupName 参数和 WebApp 参数。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Slot

指定 Web 应用部署槽的名称。可以使用 Get-AzWebAppSlot cmdlet 获取槽。部署槽位提供了一种方法来暂存和验证 Web 应用，而无需通过 Internet 访问这些应用。通常，你将更改部署到过渡站点，验证这些更改，然后部署到生产（Internet 可访问）站点。

类型:	String
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SslState

指定是否启用证书。将 SSLState 参数设置为 1 以启用证书，或将 SSLState 设置为 0 以禁用证书。

类型:	Nullable<T>[SslState]
接受的值:	Disabled, SniEnabled, IpBasedEnabled
Position:	4
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Thumbprint

指定证书的唯一标识符。

类型:	String
Position:	6
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WebApp

指定 Web 应用。若要获取 Web 应用，请使用 Get-AzWebApp cmdlet。不能在与 ResourceGroupName 参数和/或 WebAppName相同的命令中使用 WebApp 参数。

类型:	PSSite
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WebAppName

指定要为其创建新 SSL 绑定的 Web 应用的名称。不能在同一命令中使用 WebAppName 参数和 WebApp 参数。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

PSSite

输出

HostNameSslState

通过