Поделиться через

New-AzWebAppSSLBinding

Модуль:
Az.Websites Module

Создает привязку SSL-сертификата для веб-приложения Azure.

Синтаксис

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 создает привязку сертификата SSL для веб-приложения Azure. Командлет создает привязку SSL двумя способами:

  • Веб-приложение можно привязать к существующему сертификату.
  • Вы можете отправить новый сертификат и привязать веб-приложение к этому новому сертификату. Независимо от того, какой подход используется, сертификат и веб-приложение должны быть связаны с той же группой ресурсов Azure. Если у вас есть веб-приложение в группе ресурсов A и вы хотите привязать это веб-приложение к сертификату в группе ресурсов B, единственный способ сделать это — отправить копию сертификата в группу ресурсов A. Если вы отправляете новый сертификат, помните о следующих требованиях к SSL-сертификату Azure:
  • Сертификат должен содержать закрытый ключ.
  • Сертификат должен использовать формат PFX.
  • Имя субъекта сертификата должно соответствовать домену, используемому для доступа к веб-приложению.
  • Сертификат должен использовать не менее 2048-разрядного шифрования.

Примеры

Пример 1. Привязка сертификата к веб-приложению

New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"

Эта команда привязывает существующий сертификат Azure (сертификат с E3A38EBA60CAA1C162785A2E1C44A15AD450199C3 отпечатка) к веб-приложению с именем ContosoWebApp.

Пример 2

Создает привязку SSL-сертификата для веб-приложения Azure. (autogenerated)

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

powershell

Пример 3

Создает привязку SSL-сертификата для веб-приложения Azure. (autogenerated)

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

Параметры

-CertificateFilePath

Указывает путь к файлу для отправки сертификата. Параметр CertificateFilePath требуется только в том случае, если сертификат еще не отправлен в Azure.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

S1
Position:4
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
S3
Position:4
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CertificatePassword

Указывает пароль расшифровки для сертификата.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

S1
Position:5
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
S3
Position:5
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Указывает имя веб-приложения.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:3
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceGroupName

Указывает имя группы ресурсов, которому назначен сертификат. Параметр ResourceGroupName и параметр WebApp нельзя использовать в той же команде.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

S1
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
S2
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Slot

Указывает имя слота развертывания веб-приложения. Для получения слота можно использовать командлет Get-AzWebAppSlot. Слоты развертывания позволяют выполнять этапы и проверять веб-приложения без доступа к этим приложениям через Интернет. Как правило, вы развернете изменения на промежуточном сайте, проверьте эти изменения, а затем развернете его на рабочем (доступном в Интернете) сайте.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow: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]

Default value:None
Допустимые значения:Disabled, SniEnabled, IpBasedEnabled
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:4
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Thumbprint

Указывает уникальный идентификатор сертификата.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

S2
Position:6
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
S4
Position:6
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WebApp

Указывает веб-приложение. Чтобы получить веб-приложение, используйте командлет Get-AzWebApp. Параметр WebApp нельзя использовать в той же команде, что и параметр ResourceGroupName и (или) WebAppName.

Свойства параметра

Тип:PSSite
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

S3
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
S4
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WebAppName

Указывает имя веб-приложения, для которого создается новая привязка SSL. Параметр WebAppName и параметр WebApp нельзя использовать в той же команде.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

S1
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
S2
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

PSSite

Выходные данные

Microsoft.Azure.Management.WebSites.Models.HostNameSslState