Remove-RdsSessionHost

Módulo:: Microsoft.RDInfra.RDPowershell

Quita un host de sesión de un grupo de hosts.

Sintaxis

Remove-RdsSessionHost
      [-TenantName] <String>
      [-HostPoolName] <String>
      [-Name] <String>
      [-Force]
      [<CommonParameters>]

Description

El cmdlet Remove-RdsSessionHost quita un host de sesión registrado del grupo de hosts. Para volver a registrar el host de sesión en un grupo de hosts, debe volver a instalar el agente con información de registro válida para ese grupo de hosts.

Este comando fallará si el host de sesión tiene sesiones de usuario activas. Para completar la eliminación del host de sesión, primero debe cerrar la sesión de todos los usuarios del host de sesión mediante el cmdlet Invoke-RdsUserSessionLogoff o volver a ejecutar el cmdlet Remove-RdsSessionHost con el parámetro Forzar.

Al ejecutar este comando para quitar un host de sesión de un grupo de hosts persistentes, también se quita la asignación de usuario. Esta es la única manera de reasignar un usuario a un nuevo host de sesión en un grupo de hosts persistentes.

Ejemplos

Ejemplo 1: Quitar un host de sesión que no tiene sesiones activas

PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"

Este comando quita un host de sesión de un grupo de hosts. Al ejecutar el cmdlet Remove-RdsSessionHost sin el modificador Forzar, solo se realizará correctamente si no hay sesiones activas en el host de sesión especificado. Para obligar a los usuarios a cerrar la sesión del host de sesión, puede ejecutar el cmdlet Invoke-RdsUserSessionLogoff.

Ejemplo 2: Eliminación de un host de sesión mediante el modificador de fuerza

PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force

Este comando quita un host de sesión de un grupo de hosts. Al ejecutar el cmdlet Remove-RdsSessionHost con el modificador Forzar, el host de sesión se quitará inmediatamente de la base de datos, junto con la información de la sesión de usuario. Esto no cierra automáticamente la sesión de los usuarios y puede dar lugar a que un usuario pierda su estado de sesión si se desconecta accidentalmente de su sesión antes de realizar un cierre de sesión.

Parámetros

-Force

Fuerza la eliminación del host de sesión, incluso si hay objetos de sesión de usuario contenidos con el host de sesión.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-HostPoolName

Nombre del HostPool.

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Nombre de SessionHost.

Tipo:	String
Alias:	SessionHostName
Posición:	2
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-TenantName

Nombre del inquilino.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Entradas

System.String

Salidas

System.Object

Compartir a través de