Set-AzureServiceRemoteDesktopExtension
Включает расширение удаленного рабочего стола для указанных ролей или всех ролей в развернутой службе или при развертывании.
Примечание.
Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами 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-AzureServiceRemoteDesktopExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[-Credential] <PSCredential>
[[-Expiration] <DateTime>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureServiceRemoteDesktopExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[-CertificateThumbprint] <String>
[[-ThumbprintAlgorithm] <String>]
[-Credential] <PSCredential>
[[-Expiration] <DateTime>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Описание
Командлет Set-AzureServiceRemoteDesktopExtension включает расширение удаленного рабочего стола для указанных ролей или всех ролей в развернутой службе или при развертывании.
Примеры
Пример 1. Включение расширения удаленного рабочего стола
PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $credsЭта команда включает расширение удаленного рабочего стола для указанной службы.
Пример 2. Включение расширения удаленного рабочего стола для указанной роли
PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds -Role "WebRole1"Эта команда включает расширение удаленного рабочего стола для указанной службы и роли.
Параметры
-CertificateThumbprint
Указывает отпечаток сертификата, используемый для шифрования частной конфигурации. Этот сертификат уже должен существовать в хранилище сертификатов. Если сертификат не указан, этот командлет создает сертификат.
| Тип: | String |
| Position: | 3 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Credential
Указывает учетные данные для включения удаленного рабочего стола. Учетные данные включают имя пользователя и пароль.
| Тип: | PSCredential |
| Position: | 5 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Expiration
Указывает объект даты и времени, позволяющий пользователю указывать время истечения срока действия учетной записи пользователя.
| Тип: | DateTime |
| Position: | 6 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ExtensionId
Указывает идентификатор расширения.
| Тип: | String |
| Position: | 8 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | 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 |
-Profile
Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.
| Тип: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | 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: | 7 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-X509Certificate
Указывает сертификат x509, который автоматически отправляется в облачную службу и используется для шифрования частной конфигурации расширения.
| Тип: | X509Certificate2 |
| Position: | 3 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |