Remove-RdsSessionHost

Reference

Modul:: WindowsVirtualDesktopPowershell

Odebere hostitele relace z fondu hostitelů.

Syntax

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

Description

Rutina Remove-RdsSessionHost odebere registrovaného hostitele relace z fondu hostitelů. Chcete-li znovu zaregistrovat hostitele relace do fondu hostitelů, musíte znovu nainstalovat agenta s platnými registračními informacemi pro tento fond hostitelů.

Tento příkaz selže, pokud má hostitel relace aktivní uživatelské relace. Chcete-li dokončit odebrání hostitele relace, musíte nejprve odhlásit všechny uživatele z hostitele relace pomocí rutiny Invoke-RdsUserSessionLogoff nebo znovu spustit rutinu Remove-RdsSessionHost s parametrem Force.

Při spuštění tohoto příkazu pro odebrání hostitele relace z trvalého fondu hostitelů se odebere také přiřazení uživatele. Je to jediný způsob, jak znovu přiřadit uživatele k novému hostiteli relace v trvalém fondu hostitelů.

Příklady

Příklad 1: Odebrání hostitele relace, který nemá žádné aktivní relace

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

Tento příkaz odebere hostitele relace z fondu hostitelů. Spuštěním rutiny Remove-RdsSessionHost bez přepínače Force dojde k úspěchu pouze v případě, že na zadaném hostiteli relace nejsou žádné aktivní relace. Pokud chcete vynutit, aby se uživatelé odhlašují od hostitele relace, můžete spustit rutinu Invoke-RdsUserSessionLogoff.

Příklad 2: Odebrání hostitele relace pomocí přepínače vynucení

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

Tento příkaz odebere hostitele relace z fondu hostitelů. Spuštěním rutiny Remove-RdsSessionHost s přepínačem Force se hostitel relace okamžitě odebere z databáze spolu s informacemi o uživatelské relaci. Tím se uživatelé neodhlašují automaticky a může dojít ke ztrátě stavu relace, pokud se omylem odpojí od své relace před provedením odhlášení.

Parametry

-Force

Vynutí odebrání hostitele relace, i když jsou s hostitelem relace obsaženy objekty relace uživatele.

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

-HostPoolName

Název fondu hostitelů.

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

-Name

Název hostitele relace.

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

-TenantName

Název tenanta.

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

Vstupy

System.String

Výstupy

System.Object