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


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
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Указывает учетные данные для включения удаленного рабочего стола. Учетные данные включают имя пользователя и пароль.

Тип:PSCredential
Position:5
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Expiration

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

Тип:DateTime
Position:6
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionId

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

Тип:String
Position:8
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

Указывает, как этот командлет реагирует на событие сведений.

Допустимые значения для этого параметра:

  • Продолжить
  • Пропустить
  • Спрашивать
  • SilentlyContinue
  • Остановить
  • Приостановить
Тип:ActionPreference
Aliases:infa
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Указывает переменную сведений.

Тип:String
Aliases:iv
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:AzureSMProfile
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Role

Указывает необязательный массив ролей, для которых необходимо указать конфигурацию удаленного рабочего стола. Если этот параметр не указан, конфигурация удаленного рабочего стола применяется в качестве конфигурации по умолчанию для всех ролей.

Тип:String[]
Position:2
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Указывает имя службы Azure для развертывания.

Тип:String
Position:0
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-Slot

Указывает среду развертывания для изменения. Допустимые значения для этого параметра: Рабочая, промежуточная.

Тип:String
Position:1
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-ThumbprintAlgorithm

Указывает алгоритм хэширования отпечатков, который используется с отпечатком для идентификации сертификата. Этот параметр является необязательным, а значение по умолчанию — sha1.

Тип:String
Position:4
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

Указывает версию расширения.

Тип:String
Position:7
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-X509Certificate

Указывает сертификат x509, который автоматически отправляется в облачную службу и используется для шифрования частной конфигурации расширения.

Тип:X509Certificate2
Position:3
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False