Get-RdsDiagnosticActivities
Pobiera szczegóły akcji użytkownika w systemie.
Składnia
Get-RdsDiagnosticActivities
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-ActivityType <ActivityType>]
[-UserName <String>]
[-ActivityId <Guid>]
[-Outcome <Outcome>]
[-TenantName <String>]
[-Deployment]
[-Detailed]
[<CommonParameters>]
Opis
Polecenie cmdlet Get-RdsDiagnosticActivities pobiera szczegóły akcji użytkownika w systemie, zarówno dla użytkowników końcowych, jak i dla celów administracyjnych. Listę działań można filtrować według następujących parametrów:
- Identyfikator działania
- Typ działania
- Wynik
- StartTime (i opcjonalnie, EndTime)
- Nazwa użytkownika
Można połączyć wiele filtrów w jedno zapytanie. Jeśli nie określisz godziny rozpoczęcia lub zakresu czasu, zostanie wyświetlona lista działań tylko w ciągu ostatniej godziny. Możesz również wykonać zapytanie za pomocą parametru -Detailed, aby otrzymywać dodatkowe informacje o poszczególnych działaniach. Dodatkowe informacje dotyczące poszczególnych działań różnią się w zależności od typu działania.
Przykłady
Przykład 1. Pobieranie podstawowych działań diagnostycznych w dzierżawie
PS C:\> Get-RdsDiagnosticActivities -TenantName "contoso"
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:20:00 PM
EndTime :
UserName : user1@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782CE977;mrs-eus2r0c001-rdbroker-prod-staging::RD2818785C1CF1;sh1.contoso.com;
Outcome :
Status : Ongoing
Details :
LastHeartbeatTime : 1/1/2018 4:01:00 PM
Checkpoints :
Errors :
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Feed
StartTime : 1/1/2018 3:52:20 PM
EndTime : 1/1/2018 3:52:26 PM
UserName : user2@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdbroker-prod-staging::RD28187853BC78;
Outcome : Success
Status : Completed
Details :
LastHeartbeatTime : 1/1/2018 3:52:26 PM
Checkpoints :
Errors :
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Management
StartTime : 1/1/2018 3:44:54 PM
EndTime : 1/1/2018 3:44:54 PM
UserName : admin@contoso.com
RoleInstances : mrs-eus2r0c001-rdbroker-prod-staging::RD28187853BC78;
Outcome : Success
Status : Completed
Details :
LastHeartbeatTime : 1/1/2018 3:44:54 PM
Checkpoints :
Errors :
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:14:15 AM
EndTime : 1/1/2018 3:18:00 AM
UserName : user2@contoso.com
RoleInstances : user2client.contoso.com;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782C3626;mrs-eus2r0c001-rdbroker-prod::RD28187853BC78;sh1.contoso.com;
Outcome : Success
Status : Completed
Details :
LastHeartbeatTime : 1/1/2018 3:18:00 AM
Checkpoints :
Errors :
To polecenie pobiera działania dla określonej dzierżawy. Uruchamiając polecenie cmdlet Get-RdsDiagnosticActivities bez określania zakresu czasu, będziesz otrzymywać działania tylko w ciągu ostatniej godziny.
Przykład 2. Pobieranie szczegółowych działań diagnostycznych w dzierżawie
PS C:\> Get-RdsDiagnosticActivities -TenantName "contoso" -Detailed
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:20:00 PM
EndTime :
UserName : user1@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782CE977;mrs-eus2r0c001-rdbroker-prod-staging::RD2818785C1CF1;sh1.contoso.com;
Outcome :
Status : Ongoing
Details : {[ClientOS, ], [ClientVersion, ], [ClientType, ], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 4:01:00 PM
Checkpoints : {RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress...}
Errors : {}
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Feed
StartTime : 1/1/2018 3:52:20 PM
EndTime : 1/1/2018 3:52:26 PM
UserName : user2@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdbroker-prod-staging::RD28187853BC78;
Outcome : Success
Status : Completed
Details : {[ClientOS, Win32 Chrome 70.0.3538.110], [ClientVersion, 1.0.4-wvd], [ClientType, HTML], [ClientIPAddress, ]...}
LastHeartbeatTime : 1/1/2018 3:52:26 PM
Checkpoints : {TenantListComplete, TenantResourceComplete}
Errors : {}
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Management
StartTime : 1/1/2018 3:44:54 PM
EndTime : 1/1/2018 3:44:54 PM
UserName : admin@contoso.com
RoleInstances : mrs-eus2r0c001-rdbroker-prod-staging::RD28187853BC78;
Outcome : Success
Status : Completed
Details : {[Object, /RdsManagement/V1/TenantGroups/Default%20Tenant%20Group/Tenants/Contoso], [Method, Get], [Route,
Tenant::GetTenantAsync], [ObjectsFetched, 1]...}
LastHeartbeatTime : 1/1/2018 3:44:54 PM
Checkpoints : {}
Errors : {}
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:14:15 AM
EndTime : 1/1/2018 3:18:00 AM
UserName : user2@contoso.com
RoleInstances : user2client.contoso.com;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782C3626;mrs-eus2r0c001-rdbroker-prod::RD28187853BC78;sh1.contoso.com;
Outcome : Success
Status : Completed
Details : {[ClientOS, WINDOWS 10.0.17763], [ClientVersion, 10.0.17763.1], [ClientType, MSTSC], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 3:18:00 AM
Checkpoints : {LoadBalancedNewConnection, RdpStackAuthenticaticatedUser, RdpStackAuthorization, OnConnected...}
Errors : {}
To polecenie pobiera szczegółowe działania dla określonej dzierżawy.
Przykład 3. Pobieranie szczegółowej diagnostyki określonego działania
PS C:\> Get-RdsDiagnosticActivities -TenantName "contoso" -ActivityGuid "xxxx-xxxx-xxxx-xxxx-xxxx" -Detailed
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:20:00 PM
EndTime :
UserName : user1@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782CE977;mrs-eus2r0c001-rdbroker-prod-staging::RD2818785C1CF1;sh1.contoso.com;
Outcome :
Status : Ongoing
Details : {[ClientOS, ], [ClientVersion, ], [ClientType, ], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 4:01:00 PM
Checkpoints : {RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress...}
Errors : {}
To polecenie pobiera konkretne szczegółowe działanie.
Przykład 4. Pobieranie szczegółowej diagnostyki określonego użytkownika
PS C:\> Get-RdsDiagnosticActivities -TenantName "contoso" -UserName "user2@contoso.com" -Detailed
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Feed
StartTime : 1/1/2018 3:52:20 PM
EndTime : 1/1/2018 3:52:26 PM
UserName : user2@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdbroker-prod-staging::RD28187853BC78;
Outcome : Success
Status : Completed
Details : {[ClientOS, Win32 Chrome 70.0.3538.110], [ClientVersion, 1.0.4-wvd], [ClientType, HTML], [ClientIPAddress, ]...}
LastHeartbeatTime : 1/1/2018 3:52:26 PM
Checkpoints : {TenantListComplete, TenantResourceComplete}
Errors : {}
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:14:15 AM
EndTime : 1/1/2018 3:18:00 AM
UserName : user2@contoso.com
RoleInstances : user2client.contoso.com;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782C3626;mrs-eus2r0c001-rdbroker-prod::RD28187853BC78;sh1.contoso.com;
Outcome : Success
Status : Completed
Details : {[ClientOS, WINDOWS 10.0.17763], [ClientVersion, 10.0.17763.1], [ClientType, MSTSC], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 3:18:00 AM
Checkpoints : {LoadBalancedNewConnection, RdpStackAuthenticaticatedUser, RdpStackAuthorization, OnConnected...}
Errors : {}
To polecenie pobiera szczegółowe działania skojarzone z określoną nazwą użytkownika.
Przykład 5. Pobieranie szczegółowej diagnostyki według czasu rozpoczęcia
PS C:\> Get-RdsDiagnosticActivities -TenantName "contoso" -StartTime "1/1/2018 3:45:00 PM" -Detailed
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:20:00 PM
EndTime :
UserName : user1@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782CE977;mrs-eus2r0c001-rdbroker-prod-staging::RD2818785C1CF1;sh1.contoso.com;
Outcome :
Status : Ongoing
Details : {[ClientOS, Win32 Edge 18.17763], [ClientVersion, 1.0.4-wvd], [ClientType, HTML], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 4:01:00 PM
Checkpoints : {RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress...}
Errors : {}
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Feed
StartTime : 1/1/2018 3:52:20 PM
EndTime : 1/1/2018 3:52:26 PM
UserName : user2@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdbroker-prod-staging::RD28187853BC78;
Outcome : Success
Status : Completed
Details : {[ClientOS, Win32 Chrome 70.0.3538.110], [ClientVersion, 1.0.4-wvd], [ClientType, HTML], [ClientIPAddress, ]...}
LastHeartbeatTime : 1/1/2018 3:52:26 PM
Checkpoints : {TenantListComplete, TenantResourceComplete}
Errors : {}
To polecenie pobiera szczegółowe działania, które zostały ukończone po określonym czasie lub które były w toku od określonego czasu.
Przykład 6. Pobieranie szczegółowej diagnostyki według czasu rozpoczęcia i godziny zakończenia
PS C:\> Get-RdsDiagnosticActivities -TenantName "contoso" -StartTime "1/1/2018 3:45:00 PM" -EndTime "1/1/2018 3:50:00 PM" -Detailed
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:20:00 PM
EndTime :
UserName : user1@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782CE977;mrs-eus2r0c001-rdbroker-prod-staging::RD2818785C1CF1;sh1.contoso.com;
Outcome :
Status : Ongoing
Details : {[ClientOS, Win32 Edge 18.17763], [ClientVersion, 1.0.4-wvd], [ClientType, HTML], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 4:01:00 PM
Checkpoints : {RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress...}
Errors : {}
To polecenie pobiera szczegółowe działania, które zostały ukończone w określonym czasie lub które trwają od określonego zakresu czasu.
Przykład 7. Pobieranie szczegółowej diagnostyki według typu działania
PS C:\> Get-RdsDiagnosticActivities -TenantName "contoso" -ActivityType Connection -Detailed
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:20:00 PM
EndTime :
UserName : user1@contoso.com
RoleInstances : rdwebclient;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782CE977;mrs-eus2r0c001-rdbroker-prod-staging::RD2818785C1CF1;sh1.contoso.com;
Outcome :
Status : Ongoing
Details : {[ClientOS, Win32 Edge 18.17763], [ClientVersion, 1.0.4-wvd], [ClientType, HTML], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 4:01:00 PM
Checkpoints : {RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress, RdpConnectionProgress...}
Errors : {}
ActivityId : xxxx-xxxx-xxxx-xxxx-xxxx
ActivityType : Connection
StartTime : 1/1/2018 3:14:15 AM
EndTime : 1/1/2018 3:18:00 AM
UserName : user2@contoso.com
RoleInstances : user2client.contoso.com;mrs-eus2r0c001-rdgateway-prod-staging::RD2818782C3626;mrs-eus2r0c001-rdbroker-prod::RD28187853BC78;sh1.contoso.com;
Outcome : Success
Status : Completed
Details : {[ClientOS, WINDOWS 10.0.17763], [ClientVersion, 10.0.17763.1], [ClientType, MSTSC], [PredecessorConnectionId, ]...}
LastHeartbeatTime : 1/1/2018 3:18:00 AM
Checkpoints : {LoadBalancedNewConnection, RdpStackAuthenticaticatedUser, RdpStackAuthorization, OnConnected...}
Errors : {}
To polecenie pobiera szczegółowe działania zgodne z określonym typem działania.
Parametry
-ActivityId
Identyfikator działania.
Typ: | Guid |
Aliasy: | Id |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ActivityType
Typ działania. Działania są klasyfikowane w następujących kategoriach:
- Połączenie
- Karmić
- Zarządzanie
Typ: | ActivityType |
Aliasy: | Type |
Dopuszczalne wartości: | Connection, Management, Feed, RegistrationToken |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Deployment
Zakres specyficzny dla usługi Windows Virtual Desktop.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Detailed
Przełącznik wskazujący, aby zwrócić bardziej szczegółowe informacje dla każdego działania. Zwrócone dodatkowe informacje będą się różnić w zależności od typu każdego działania.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-EndTime
Data i godzina, która ma być używana jako górna granica dla działań związanych z wykonywaniem zapytań.
Typ: | DateTime |
Aliasy: | End |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Outcome
Wynik działania. Działania mogą mieć jeden z dwóch wyników:
- Sukces
- Niepowodzenie
Typ: | Outcome |
Dopuszczalne wartości: | Success, Failure |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-StartTime
Data i godzina użycia jako dolna granica dla działań związanych z wykonywaniem zapytań.
Typ: | DateTime |
Aliasy: | Start |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-TenantName
Nazwa dzierżawy skojarzonej z działaniem.
Typ: | String |
Aliasy: | Tenant |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-UserName
Główna nazwa użytkownika (UPN) użytkownika skojarzonego z działaniem.
Typ: | String |
Aliasy: | User |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
System.Nullable`1[[System.DateTime, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Nullable`1[[Microsoft.RDInfra.Diagnostics.Common.ActivityType, Microsoft.RDInfra.Diagnostics.Common, Version=1.0.0.1, Culture=neutral, PublicKeyToken=99498ce06f56ba9d]]
System.String
System.Nullable`1[[System.Guid, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Nullable`1[[Microsoft.RDInfra.Diagnostics.Common.Outcome, Microsoft.RDInfra.Diagnostics.Common, Version=1.0.0.1, Culture=neutral, PublicKeyToken=99498ce06f56ba9d]]
System.Management.Automation.SwitchParameter
Dane wyjściowe
System.Object