Remove-RdsSessionHost

Moduł:

Microsoft.RDInfra.RDPowershell

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żytkowników. Aby ukończyć usuwanie hosta sesji, należy najpierw wylogować wszystkich użytkowników z hosta sesji za pomocą polecenia cmdlet Invoke-RdsUserSessionLogoff lub ponownie uruchomić polecenie cmdlet Remove-RdsSessionHost z parametrem Force .

Po uruchomieniu 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, który nie ma aktywnych sesji

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

To polecenie usuwa hosta sesji z puli hostów. Uruchomienie polecenia cmdlet Remove-RdsSessionHost bez przełącznika Force zakończy się powodzeniem tylko wtedy, gdy na określonym hoście sesji nie ma aktywnych sesji. Aby wymusić na użytkownikach wylogowanie się z hosta sesji, możesz uruchomić Invoke-RdsUserSessionLogoff cmdlet.

Przykład 2: Usuwanie hosta sesji za pomocą przełącznika siły

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

To polecenie usuwa hosta sesji z puli hostów. Uruchamiając Remove-RdsSessionHost cmdlet z przełącznikiem Wymuś, 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 zostanie przypadkowo rozłączony z sesją przed wykonaniem wylogowania.

Parametry

-Force

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-HostPoolName

Nazwa puli hostów.

Typ:	String
Position:	1
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Name

Nazwa hosta sesji.

Typ:	String
Aliasy:	SessionHostName
Position:	2
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-TenantName

Nazwa najemcy.

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

System.String

Dane wyjściowe

System.Object