Disconnect-RdsUserSession
Rozłącza użytkownika z jego bieżącą aktywną sesją.
Składnia
Default (Domyślna)
Disconnect-RdsUserSession
[-TenantName] <String>
[-HostPoolName] <String>
[-SessionHostName] <String>
[-SessionId] <Int32>
[-NoUserPrompt]
[<CommonParameters>]
Opis
Polecenie cmdlet Disconnect-RdsUserSession odłącza użytkownika od bieżącej aktywnej sesji uruchomionej na określonym hoście sesji. Użytkownik nie jest wylogowany, więc wszystkie aplikacje nadal działają. Użytkownik może ponownie połączyć się ze swoją sesją, uruchamiając ponownie połączenie w swoim kliencie pulpitu zdalnego.
Przykłady
Przykład 1: Odłączanie użytkownika przez podanie wszystkich wymaganych informacji
PS C:\> Disconnect-RdsUserSession -TenantName "contoso" -HostPoolName "contosoHostPool" -SessionHostName "sh1.contoso.com" -SessionId 1
To polecenie rozłącza użytkownika na określonym hoście sesji skojarzonym z podanym identyfikatorem sesji. To polecenie wymaga wcześniejszego sprawdzenia sesji użytkownika, aby podać wszystkie wymagane informacje. Uruchamiając polecenie cmdlet Disconnect-RdsUserSession bez przełącznika NoUserPrompt, zostanie wyświetlony monit o potwierdzenie odłączenia użytkownika.
Przykład 2: Odłączanie użytkownika przez wyszukanie jego sesji użytkownika
PS C:\> Get-RdsUserSession -TenantName "contoso" -HostPoolName "contosoHostPool" | where { $_.UserPrincipalName -eq "contoso\user1" } | Disconnect-RdsUserSession -NoUserPrompt
To polecenie używa polecenia cmdlet Get-RdsUserSession do wyszukania sesji określonego użytkownika, a następnie przesyła je do polecenia cmdlet Disconnect-RdsUserSession w celu odłączenia użytkownika. Uruchamiając polecenie cmdlet Disconnect-RdsUserSession z przełącznikiem NoUserPrompt, nie otrzymasz żadnego dodatkowego monitu o potwierdzenie odłączenia użytkownika.
Parametry
-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 |
-NoUserPrompt
Przełącznik wskazujący, że chcesz odłączyć użytkownika bez dodatkowego potwierdzenia.
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 |
-SessionHostName
Nazwa hosta sesji.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
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 |
-SessionId
Identyfikator sesji odpowiadający użytkownikowi, którego chcesz odłączyć.
Właściwości parametru
| Typ: | Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 3 |
| 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 dzierżawy.
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.