通过

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

New-AzWebAppSSLBinding

模块:
Az.Websites Module

为 Azure Web 应用创建 SSL 证书绑定。

语法

S1 

New-AzWebAppSSLBinding
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    [[-Slot] <String>]
    [-Name] <String>
    [[-SslState] <SslState>]
    [-CertificateFilePath] <String>
    [-CertificatePassword] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S2 

New-AzWebAppSSLBinding
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    [[-Slot] <String>]
    [-Name] <String>
    [[-SslState] <SslState>]
    [-Thumbprint] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S3 

New-AzWebAppSSLBinding
    [-WebApp] <PSSite>
    [-Name] <String>
    [[-SslState] <SslState>]
    [-CertificateFilePath] <String>
    [-CertificatePassword] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S4 

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 证书绑定。 (autogenerated)

New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'

powershell

示例 3

为 Azure Web 应用创建 SSL 证书绑定。 (autogenerated)

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

参数

-CertificateFilePath

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:4
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
S3
Position:4
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-CertificatePassword

指定证书的解密密码。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:5
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
S3
Position:5
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

指定 Web 应用的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:3
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ResourceGroupName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
S2
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Slot

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:2
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
S2
Position:2
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SslState

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

参数属性

类型:

Nullable<T>[Microsoft.Azure.Management.WebSites.Models.SslState]

默认值:None
接受的值:Disabled, SniEnabled, IpBasedEnabled
支持通配符:False
不显示:False

参数集

(All)
Position:4
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Thumbprint

指定证书的唯一标识符。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S2
Position:6
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
S4
Position:6
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WebApp

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

参数属性

类型:PSSite
默认值:None
支持通配符:False
不显示:False

参数集

S3
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False
S4
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WebAppName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
S2
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

PSSite

输出

Microsoft.Azure.Management.WebSites.Models.HostNameSslState