Set-AzureServiceExtension
Добавляет расширение облачной службы в развертывание.
Примечание.
Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.
Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.
Внимание
Облачные службы (классическая версия) объявлены устаревшими для новых клиентов. Их поддержка будет полностью прекращена 31 августа 2024 года. Для новых развертываний следует использовать Облачные службы Azure с расширенной поддержкой. Это новая модель развертывания на основе Azure Resource Manager.
Синтаксис
Set-AzureServiceExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[-ExtensionName] <String>
[-ProviderNamespace] <String>
[-PublicConfiguration] <String>
[-PrivateConfiguration] <String>
[-Version] <String>
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureServiceExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[-CertificateThumbprint] <String>
[[-ThumbprintAlgorithm] <String>]
[-ExtensionName] <String>
[-ProviderNamespace] <String>
[-PublicConfiguration] <String>
[-PrivateConfiguration] <String>
[-Version] <String>
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Описание
Командлет Set-AzureServiceExtension добавляет расширение облачной службы в развертывание.
Примеры
Пример 1. Добавление облачной службы в развертывание
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -ExtensionName "RDP" -Version "1.0" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;Эта команда добавляет облачную службу в развертывание.
Пример 2. Добавление облачной службы в развертывание для указанной роли
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -Role "WebRole1" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;Эта команда добавляет облачную службу в развертывание для указанной роли.
Параметры
-CertificateThumbprint
Указывает отпечаток сертификата, используемый для шифрования частной конфигурации. Этот сертификат уже должен существовать в хранилище сертификатов. Если сертификат не указан, этот командлет создает сертификат.
| Тип: | String |
| Position: | 3 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ExtensionId
Указывает идентификатор расширения.
| Тип: | String |
| Position: | 10 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ExtensionName
Указывает имя расширения.
| Тип: | String |
| Position: | 5 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-InformationAction
Указывает, как этот командлет реагирует на событие сведений.
Допустимые значения для этого параметра:
- Продолжить
- Пропустить
- Спрашивать
- SilentlyContinue
- Остановить
- Приостановить
| Тип: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InformationVariable
Указывает переменную сведений.
| Тип: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PrivateConfiguration
Задает текст частной конфигурации.
| Тип: | String |
| Position: | 8 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Profile
Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.
| Тип: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ProviderNamespace
Указывает пространство имен поставщика расширений.
| Тип: | String |
| Position: | 6 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PublicConfiguration
Указывает текст общедоступной конфигурации.
| Тип: | String |
| Position: | 7 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Role
Указывает необязательный массив ролей, для которых необходимо указать конфигурацию удаленного рабочего стола. Если этот параметр не указан, конфигурация удаленного рабочего стола применяется в качестве конфигурации по умолчанию для всех ролей.
| Тип: | String[] |
| Position: | 2 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ServiceName
Указывает имя службы Azure для развертывания.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Slot
Указывает среду развертывания для изменения. Допустимые значения: Рабочая или промежуточная.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ThumbprintAlgorithm
Указывает алгоритм хэширования отпечатков, который используется с отпечатком для идентификации сертификата. Этот параметр является необязательным, а значение по умолчанию — sha1.
| Тип: | String |
| Position: | 4 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Version
Указывает версию расширения.
| Тип: | String |
| Position: | 9 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-X509Certificate
Указывает сертификат X.509, который автоматически отправляется в облачную службу и используется для шифрования частной конфигурации расширения.
| Тип: | X509Certificate2 |
| Position: | 3 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |