Remove-RdsSessionHost

Modul:

WindowsVirtualDesktopPowershell

Eltávolít egy munkamenet-gazdagépet egy gazdagépkészletből.

Syntax

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

Description

A Remove-RdsSessionHost parancsmag eltávolít egy regisztrált munkamenetgazdát a gazdagépkészletből. A munkamenet-gazdagép gazdagépkészletbe való újbóli regisztrálásához újra kell telepítenie az ügynököt az adott gazdagépkészlet érvényes regisztrációs adataival.

Ez a parancs sikertelen lesz, ha a munkamenetgazda aktív felhasználói munkamenetekkel rendelkezik. A munkamenet-gazdagép eltávolításának befejezéséhez először ki kell jelentkeznie az összes felhasználónak a munkamenet-gazdagépről a Invoke-RdsUserSessionLogoff parancsmag használatával, vagy újra kell futtatnia a Remove-RdsSessionHost parancsmagot a Force paraméterrel.

Ha ezt a parancsot futtatva eltávolít egy munkamenet-gazdagépet egy állandó gazdagépkészletből, a felhasználó-hozzárendelés is törlődik. Ez az egyetlen módja annak, hogy egy felhasználót újra hozzárendeljen egy állandó gazdagépkészlet új munkamenet-gazdagépéhez.

Példák

1. példa: Aktív munkameneteket nem tartalmazó munkamenetgazda eltávolítása

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

Ez a parancs eltávolít egy munkamenet-gazdagépet egy gazdagépkészletből. Ha a Remove-RdsSessionHost parancsmagot a Force kapcsoló nélkül futtatja, az csak akkor lesz sikeres, ha nincsenek aktív munkamenetek a megadott munkamenetgazdagépen. Ha ki szeretné kényszeríteni a felhasználókat a munkamenetgazda kijelentkezésére, futtassa a Invoke-RdsUserSessionLogoff parancsmagot.

2. példa: Munkamenet-gazdagép eltávolítása az erőkapcsolóval

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

Ez a parancs eltávolít egy munkamenet-gazdagépet egy gazdagépkészletből. Ha a Remove-RdsSessionHost parancsmagot a Force kapcsolóval futtatja, a munkamenetgazda azonnal el lesz távolítva az adatbázisból, a felhasználói munkamenet adataival együtt. Ez nem jelentkezik ki automatikusan a felhasználókról, és a felhasználó elveszítheti a munkamenet állapotát, ha a kijelentkezés előtt véletlenül megszakadt a kapcsolata a munkamenetével.

Paraméterek

-Force

Kényszeríti a munkamenetgazda eltávolítását, még akkor is, ha a munkamenetgazda tartalmaz felhasználói munkamenet-objektumokat.

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

-HostPoolName

Gazdagépkészlet neve.

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

-Name

SessionHost neve.

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

-TenantName

Bérlő neve.

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

Bevitelek

System.String

Kimenetek

System.Object