| HostAccountName |
Specify the managed host account name. |
| Keyword |
(Optional) Specify a keyword that can be used to group managed hosts in the Managed host view of the Manager. |
| ResourceActivityEnabled |
(Optional) Specify this parameter to enable resource activity collection.
Resource activity collection is disabled by default. You can, enable it for locally managed Windows servers, SharePoint farms, and supported NetApp and EMC remotely managed hosts. It is used to collect data on identities, reads, writes, creates, deletes, renames and security changes on securable objects. This information is required for several report types, including the Resource Activity report. |
| Granularity |
(Optional) Specify how often (in minutes) you would like to synchronize and aggregate the data. That is, this is the amount of time the agent is to record new activity before sending results to the Data Governance server. The value entered will be changed to a valid aggregation interval, as follows:
- Values less than 10 minutes will be set to 5 minutes.
- Values between 10 minutes and 2 hours will be set to 1 hour.
- Values between 2 hours and 15 hours will be set to 8 hours.
- Values greater than 15 hours will be set to 1 day.
NOTE: Identical activity generated during this time will be recorded as one activity. |
| ExcludedTrusteesImportFile |
(Optional) Specify the path to a file containing a list of accounts to be excluded from the index scans.
This parameter only applies to managed hosts with resource activity enabled. |
| ExcludedFileTypesImportFile |
(Optional) Specify the path to a file containing a list of file types to be excluded from the index scans.
This parameter only applies to managed hosts with resource activity enabled. |
| ExcludedFoldersImportFile |
(Optional) Specify the path to a file containing a list of the folders on the computer (paths) to be excluded from the index scans.
This parameter only applies to managed hosts with resource activity enabled. |
| AgentHostName |
For remote managed hosts, provide the name of the computer where the scanning agent will reside. |
| SelectedDataRoots |
Specify one or more NTFS directories (or a point in your SharePoint farm hierarchy) to be scanned by the agent. By default, everything under a selected data roots (paths) is scanned.
For remote managed hosts and SharePoint hosts, define the paths to be scanned.
For local managed hosts, the agent performs a full scan of the computer by default; however, you can optionally specify the paths to be scanned by the agent. Once configured, only those managed paths are scanned. |
| ScheduleType |
Specifies the time and frequency with which the agent scans the target computer. Valid values are:
- DaysOfWeek: Use to specify a daily scan schedule. If you specify this value, you must also specify the RunOnDays and ScheduledTime parameters.
- Interval: Use to scan the target computer on an hourly interval instead of a daily schedule. If you specify this value, you must also specify the ScanInterval parameter.
- RunOnce: Use to scan the target computer only one time.
This parameter is required for remotely scanned managed hosts. |
| RunOnDays |
If the ScheduleType is set to "DaysOfWeek", specify the days you would like the agent to scan the managed host.
The syntax is DayOne for Sunday, DayTwo for Monday, etc. For example, to set a scan schedule for Monday, Wednesday and Friday, you would specify ScheduledDays DayTwo,DayFour,DaySix.
For remote managed hosts, optionally specify this parameter to define the days of the week to be included in the scan schedule.
If this parameter is not specified, all days of the week are included by default. |
| ScheduledTime |
If the ScheduleType is set to "DaysOfWeek", specify the time of day when the scan is scheduled to start.
The syntax is, hh:mm:ss. For example, to start a scan at 4 a.m., specify -ScheduledTime 4:00:00; for 6 p.m., specify -ScheduledTime 18:00:00.
For remote managed hosts, optionally specify this parameter to define the time of day when the scan is scheduled to start.
If this parameter is not specified, the default start time is 2:00:00 AM. |
| ScanInterval |
If the ScheduleType is set to "Interval", specify the interval (in hours) at which the agent will scan the managed host.
For example, to scan every 4 hours, specify -ScanInterval 4.
If this parameter is not specified, the default is 24 hours (or 1 day). |
| ServiceAccountId |
If deploying a remotely managed host, you must supply the GUID of the service account that the agent will use to access the remote managed hosts files.
Run the Get-QServiceAccounts cmdlet to get a list of service accounts registered with Data Governance Edition and their IDs. |
| EnableRemoteFileSystemChangeWatching |
(Optional) Specify this parameter if you want to collect activity for real-time security updates for the scanned managed host.
NOTE: Real-time security updates in the context of Data Governance Edition refers to the monitoring of changes to the file system caused by create, delete, and rename operations, as well as DACL, SACL and Owner changed, in order to maintain the security index. These real-time security updates are not monitored by default. |
| OverrideScanScheduleOnStartup |
(Optional) Set this flag when you want the agent to do a full scan immediately when the agent is added, or perform a rescan when the agent service is restarted.
Valid values are:
-
1 or $true: Perform scan when agent is started or restarted. (Default for local managed hosts).
If the parameter is specified without a value, set to $true and perform a full scan when agent is started or restarted.
-
0 or $false: Do not perform scan when agent is started or restarted. (Default for remote managed hosts.)
If the parameter is not specified, set to $false and do not perform a full scan when agent is started or restarted.
For example, to override the scan schedule when an agent is started or restarted: -OverrideScanScheduleOnStartup 1 |
| HostType |
(Optional) Specify the type of computer the agent will be monitoring. Valid values include:
- WindowsServer (Default)
- OnTapDevice
- CelerraDevice
- WindowsCluster
- SharePointFarm
- GenericHostType
- DistributedFileSystemRoot
- IsilonDevice
- IsilonNfsDevice
- OnTapNfsDevice
- OnTapClusterNfsDevice
- OnTapClusterCifsDevice
If this parameter is not specified, WindowsServer is the default host type. |
| DataRootType |
(Optional) Specify the type of data root. Valid values include:
If this parameter is not specified, defaults to Folder. |
| IsManagedResourceHost |
(Optional) Specify this parameter if you want this managed host to be used to host managed resources (for example, file shares created through the IT Shop self-service request functionality).
- $false: (Default) Can not host a managed resource
- $true: Can host a managed resource
|
| IgnoreFiles |
(Optional) Specify if you want the scanner to include files that have explicit permissions set. If this switch parameter is not present, the managed host scanner will ignore files.
This flag is purely for scanning optimization. |
