Remove-RdsSessionHost

Odwołanie

Moduł:: WindowsVirtualDesktopPowershell

Usuwa hosta sesji z puli hostów.

Składnia

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

Opis

Polecenie cmdlet Remove-RdsSessionHost usuwa zarejestrowanego hosta sesji z puli hostów. Aby ponownie zarejestrować hosta sesji w puli hostów, należy ponownie zainstalować agenta z prawidłowymi informacjami rejestracyjnymi dla tej puli hostów.

To polecenie zakończy się niepowodzeniem, jeśli host sesji ma aktywne sesje użytkownika. Aby ukończyć usuwanie hosta sesji, należy najpierw wylogować wszystkich użytkowników z hosta sesji przy użyciu polecenia cmdlet Invoke-RdsUserSessionLogoff lub ponownie uruchomić polecenie cmdlet Remove-RdsSessionHost z parametrem Force.

Podczas uruchamiania tego polecenia w celu usunięcia hosta sesji z trwałej puli hostów przypisanie użytkownika jest również usuwane. Jest to jedyny sposób ponownego przypisania użytkownika do nowego hosta sesji w trwałej puli hostów.

Przykłady

Przykład 1. Usuwanie hosta sesji bez aktywnych sesji

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

To polecenie usuwa hosta sesji z puli hostów. Uruchamiając polecenie cmdlet Remove-RdsSessionHost bez przełącznika wymuszenia, powiedzie się tylko wtedy, gdy na określonym hoście sesji nie ma aktywnych sesji. Aby zmusić użytkowników do wylogowania się z hosta sesji, możesz uruchomić polecenie cmdlet Invoke-RdsUserSessionLogoff.

Przykład 2. Usuwanie hosta sesji przy użyciu przełącznika wymuszania

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

To polecenie usuwa hosta sesji z puli hostów. Uruchamiając polecenie cmdlet Remove-RdsSessionHost z przełącznikiem wymuszenia, host sesji zostanie natychmiast usunięty z bazy danych wraz z informacjami o sesji użytkownika. Nie powoduje to automatycznego wylogowania użytkowników i może spowodować utratę stanu sesji przez użytkownika, jeśli zostaną przypadkowo odłączeni od sesji przed wykonaniem wylogowania.

Parametry

-Force

Wymusza usunięcie hosta sesji, nawet jeśli istnieją obiekty sesji użytkownika zawarte z hostem sesji.

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

-HostPoolName

Nazwa puli hostów.

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

-Name

Nazwa hosta sesji.

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

-TenantName

Nazwa dzierżawy.

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

Dane wejściowe

System.String

Dane wyjściowe

System.Object