你当前正在访问 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 参数。

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

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

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 cmdlet 获取槽。 部署槽位提供了一种方法来暂存和验证 Web 应用，而无需通过 Internet 访问这些应用。 通常，你将更改部署到过渡站点，验证这些更改，然后部署到生产（Internet 可访问）站点。

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 cmdlet。 不能在 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

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PSSite

输出

HostNameSslState