Retrieves the activity associated with a resource. The results provide a granular list of activities recorded over a period of time that can be used to verify proper resource usage and make decisions on modifying access.
Note: Resource activity collection (and therefore, this cmdlet) is not supported for the following host types:
- Windows Cluster/Remote Windows Computer
- Generic Host Type
- EMC Isilon NFS Device
- SharePoint Online
- OneDrive for Business
Syntax:
Get-QResourceActivity [-ManagedHostId] <String> [-Resources] <String[]> [[-StartTime] [<DateTime>]] [[-EndTime] [<DateTime>]] [[-Exclusions] [<String[]>]] [[-ExcludedOperations] [<String[]>]] [<CommonParameters>]
| Parameter | Description |
|---|---|
| ManagedHostId |
Specify the ID (GUID format) of the managed host that you would like to see resource activity for. Run the Get-QManagedHosts cmdlet without any parameters to retrieve a list of available managed hosts and their IDs. |
| Resources |
Specify the specific resource you would like to see resource activity for. Specify NTFS resources in the following format: "C:\Share","C:\ADFS" When specifying multiple resources, separate the resources with a comma. |
| StartTime |
(Optional) Specify the start date and time from which you want to see resource activity. Specify the start time in the following format (UTC): "23/01/2016 10:36:30 PM" |
| EndTine |
(Optional) Specify the end date and time up to which you want to see resource activity. Specify the end time in the following format (UTC): "23/01/2016 11:36:30 PM" |
| Exclusions |
(Optional) Specify the security identifier (SID) of the users to be excluded from the resource activity search. Specify the SIDs to exclude using the following format: domain: S-1-5-21 Example: TSX:S-1-5-21-3263556741-3296809600-1972185209-1104 |
| ExcludedOperations |
(Optional) Specify the operations to be excluded from the resource activity search. Valid values are:
When specifying multiple operations, separate the operations with a comma. |
Examples:
| Example | Description |
|---|---|
| Get-QResourceActivity "ce21c3ec-3b79-4225-955a-c54cb46790f1" "C:\Share","C:\ADFS" | Retrieves all activity on the specified managed host for the "C:\Share" and "C:\ADFS" folders. |
Details retrieved:
| Detail | Description |
|---|---|
| NodeId | The ID used to link the activity database to the QAMNode table. (AuditNodeId in QAMNode table.) |
| ResourceId | The ID assigned to the operation that was performed. |
| ParentResourceId | Shows which resource in the activity database is the parent. |
| ResourcePath | The path of the resource. |
| ResourceName | The name of resource. |
| Resource | The type of resource. |
| Operation | The operation that was performed. |
| AccessCount | The number of times the operation occurred during the aggregation interval. |
| StartTime | The start date and time for collecting resource activity. Activity is stored in 'time spans'. |
| EndTime | The end date and time for collecting resource activity. Activity is stored in 'time spans'. |
| TrusteeType | The type of account that initiated the operation. |
| TrusteeName | The name of the account that initiated the operation. |
| TrusteeSid | The security identifier (SID) assigned to the account that initiated the operation, |
| AuditTrusteeId | The ID associated with the account that performed the operation. (UID_QAMTrustee in QAMTrustee table.) |