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.) |