Remove-RdsSessionHost
Usuwa hosta sesji z puli hostów.
Składnia
Default (Domyślna)
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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-HostPoolName
Nazwa puli hostów.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Nazwa hosta sesji.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | NazwaHostaSesji |
Zestawy parametrów
(All)
| Position: | 2 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-TenantName
Nazwa najemcy.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.