New-AzureRmWebAppSSLBinding
Создает привязку SSL-сертификата для веб-приложения Azure.
Предупреждение
Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Описание
Командлет New-AzureRmWebAppSSLBinding создает привязку сертификата SSL для веб-приложения Azure. Командлет создает привязку SSL двумя способами:
- Веб-приложение можно привязать к существующему сертификату.
- Вы можете отправить новый сертификат и привязать веб-приложение к этому новому сертификату. Независимо от того, какой подход используется, сертификат и веб-приложение должны быть связаны с той же группой ресурсов Azure. Если у вас есть веб-приложение в группе ресурсов A и вы хотите привязать это веб-приложение к сертификату в группе ресурсов B, единственный способ сделать это — отправить копию сертификата в группу ресурсов A. Если вы отправляете новый сертификат, помните о следующих требованиях к SSL-сертификату Azure:
- Сертификат должен содержать закрытый ключ.
- Сертификат должен использовать формат PFX.
- Имя субъекта сертификата должно соответствовать домену, используемому для доступа к веб-приложению.
- Сертификат должен использовать как минимум 2048-разрядное шифрование.
Примеры
Пример 1. Привязка сертификата к веб-приложению
PS C:\>New-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"Эта команда привязывает существующий сертификат Azure (сертификат с E3A38EBA60CAA1C162785A2E1C44A15AD450199C3 отпечатка) к веб-приложению с именем ContosoWebApp.
Параметры
-CertificateFilePath
Указывает путь к файлу для отправки сертификата. Параметр CertificateFilePath требуется только в том случае, если сертификат еще не отправлен в Azure.
| Тип: | String |
| Position: | 4 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CertificatePassword
Указывает пароль расшифровки для сертификата.
| Тип: | String |
| Position: | 5 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
| Тип: | IAzureContextContainer |
| Aliases: | 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-AzureRMWebAppSlot. Слоты развертывания позволяют выполнять этапы и проверять веб-приложения без доступа к этим приложениям через Интернет. Как правило, вы развернете изменения на промежуточном сайте, проверьте эти изменения, а затем развернете его на рабочем (доступном в Интернете) сайте.
| Тип: | 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-AzureRmWebApp. Параметр 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 |
Входные данные
Параметры: WebApp (ByValue)