New-AzWebAppSSLBinding
Создает привязку SSL-сертификата для веб-приложения Azure.
Синтаксис
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 создает привязку сертификата 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. (автоматическое создание)
New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'powershell
Пример 3
Создает привязку SSL-сертификата для веб-приложения Azure. (автоматическое создание)
New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'Параметры
-CertificateFilePath
Указывает путь к файлу для отправки сертификата. Параметр CertificateFilePath требуется только в том случае, если сертификат еще не отправлен в Azure.
| Тип: | String |
| Position: | 4 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CertificatePassword
Указывает пароль расшифровки для сертификата.
| Тип: | String |
| Position: | 5 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
| Тип: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Указывает имя веб-приложения.
| Тип: | String |
| Position: | 3 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ResourceGroupName
Указывает имя группы ресурсов, которому назначен сертификат. Параметр ResourceGroupName и параметр WebApp нельзя использовать в той же команде.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Slot
Указывает имя слота развертывания веб-приложения. Для получения слота можно использовать командлет Get-AzWebAppSlot. Слоты развертывания позволяют выполнять этапы и проверять веб-приложения без доступа к этим приложениям через Интернет. Как правило, вы развернете изменения на промежуточном сайте, проверьте эти изменения, а затем развернете его на рабочем (доступном в Интернете) сайте.
| Тип: | String |
| Position: | 2 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SslState
Указывает, включен ли сертификат. Задайте для параметра SSLState значение 1, чтобы включить сертификат или задать значение SSLState значение 0, чтобы отключить сертификат.
| Тип: | Nullable<T>[SslState] |
| Допустимые значения: | Disabled, SniEnabled, IpBasedEnabled |
| Position: | 4 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Thumbprint
Указывает уникальный идентификатор сертификата.
| Тип: | String |
| Position: | 6 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WebApp
Указывает веб-приложение. Чтобы получить веб-приложение, используйте командлет Get-AzWebApp. Параметр WebApp нельзя использовать в той же команде, что и параметр ResourceGroupName и (или) WebAppName.
| Тип: | PSSite |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-WebAppName
Указывает имя веб-приложения, для которого создается новая привязка SSL. Параметр WebAppName и параметр WebApp нельзя использовать в той же команде.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |