Remove-RdsSessionHost
Удаляет узел сеансов из пула узлов.
Синтаксис
Default (по умолчанию)
Remove-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-Force]
[<CommonParameters>]
Описание
Командлет Remove-RdsSessionHost удаляет зарегистрированный узел сеансов из пула узлов. Чтобы повторно зарегистрировать узел сеансов в пуле узлов, необходимо переустановить агент с действительными регистрационными данными для этого пула узлов.
Эта команда завершится ошибкой, если на узле сеансов есть активные пользовательские сеансы. Чтобы завершить удаление узла сеансов, необходимо сначала выйти из системы всех пользователей узла сеансов с помощью командлета Invoke-RdsUserSessionLogoff или повторно запустить командлет Remove-RdsSessionHost с параметром Force.
При выполнении этой команды для удаления узла сеансов из постоянного пула узлов назначение пользователя также удаляется. Это единственный способ повторно назначить пользователя новому узлу сеансов в пуле постоянных узлов.
Примеры
Пример 1: Удаление узла сеансов, у которого нет активных сеансов
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"
Эта команда удаляет узел сеансов из пула узлов. При выполнении командлета Remove-RdsSessionHost без переключателя Force он будет успешным только в том случае, если на указанном узле сеансов нет активных сеансов. Чтобы заставить пользователей выйти из системы узла сеансов, можно выполнить командлет Invoke-RdsUserSessionLogoff.
Пример 2: Удаление узла сеанса с помощью переключателя силы
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force
Эта команда удаляет узел сеансов из пула узлов. При выполнении командлета Remove-RdsSessionHost с переключателем Force узел сеанса будет немедленно удален из базы данных вместе с информацией о сеансе пользователя. Это не приводит к автоматическому выходу пользователей из системы и может привести к потере состояния сеанса, если он случайно отключится от сеанса до выполнения выхода из системы.
Параметры
-Force
Принудительное удаление узла сеанса, даже если в узле сеанса содержатся объекты пользовательского сеанса.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-HostPoolName
Имя HostPool.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Имя узла сеанса.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | ИмяХостаСессии |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-TenantName
Имя клиента.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.