Partilhar via


Remove-RdsSessionHost

Remove um anfitrião de sessão de uma piscina de anfitriões.

Syntax

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

Description

O Remove-RdsSessionHost cmdlet remove um anfitrião de sessão registado da piscina anfitriã. Para voltar a registar o anfitrião da sessão numa piscina de anfitriões, tem de reinstalar o agente com informações válidas de registo para esse pool anfitrião.

Este comando falhará se o anfitrião da sessão tiver sessões de utilizador ativas. Para completar a remoção do anfitrião da sessão, deve primeiro iniciar sessão com todos os utilizadores do anfitrião da sessão utilizando o cmdlet Invoke-RdsUserSessionLogoff ou re-executar o Remove-RdsSessionHost cmdlet com o parâmetro Force.

Ao executar este comando para remover um anfitrião de sessão de uma piscina de anfitrião persistente, a atribuição do utilizador também é removida. Esta é a única maneira de reatribuir um utilizador a um novo anfitrião de sessão numa piscina de anfitriões persistente.

Exemplos

Exemplo 1: Remover um anfitrião de sessão que não tem sessões ativas

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

Este comando remove um anfitrião de sessão de uma piscina de anfitriões. Ao executar o Remove-RdsSessionHost cmdlet sem o interruptor Force, só será bem sucedido se não houver sessões ativas no anfitrião de sessão especificado. Para forçar os utilizadores a iniciar sessão do anfitrião da sessão, pode executar o Invoke-RdsUserSessionLogoff cmdlet.

Exemplo 2: Remover um anfitrião de sessão utilizando o interruptor de força

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

Este comando remove um anfitrião de sessão de uma piscina de anfitriões. Ao executar o Remove-RdsSessionHost cmdlet com o interruptor Force, o anfitrião da sessão será imediatamente removido da base de dados, juntamente com as informações da sessão do utilizador. Isto não regista automaticamente os utilizadores e pode resultar na perda do estado de sessão por parte de um utilizador se estes forem acidentalmente desligados da sessão antes de realizarem um registo.

Parâmetros

-Force

Força a remoção do anfitrião da sessão, mesmo que existam objetos de sessão de utilizador contidos com o anfitrião da sessão.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostPoolName

Nome HostPool.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

SessãoO nome.

Type:String
Aliases:SessionHostName
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantName

Nome do inquilino.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

System.String

Saídas

System.Object