Returns where users and groups have access on a managed host.
Syntax:
Get-QAcccountAccess [-ManagedHostId] <String> [-TargetType] <QAM.Client.PowerShell.TargetType> [-TargetId] <String> [-ResType] <QAM.Client.PowerShell.QueryResourceType> [[-AccountOrigin] [<String>] [[-Direct] [<SwitchParameter>]] [[-Exclusions] [<String[]>]] [[-DataUnderGovernance] [<SwitchParameter>]] [<CommonParameters>]
Parameter | Description |
---|---|
ManagedHostId |
Specify the ID (GUID format) of the managed host whose access you are interested in. Run the Get-QManagedHosts command to retrieve a list of managed hosts and their IDs. |
TargetType |
Specify one of the following types for the target object:
|
TargetId | Specify the ObjectSid for the account or employee. |
ResType |
Specify the type of resource to be queried. Valid values are:
|
AccountOrigin |
(Optional) Specify the origin of the trustee SID specified in the query. Enter the DNS name of the reference domain or computer for the SID. If this parameter is not specified, the server will attempt to infer it. |
Direct |
(Optional) Specify this parameter if you want the query to retrieve only direct access points. If this parameter is not specified, group membership expansion should be taken into account. |
Exclusions |
(Optional) Specify a list of trustees that are not to be considered for account access via group membership. This means that if the account being considered is a member of one of the excluded trustees, that access will be ignored. The list must be an array of strings in the following format: [domain DNS name:]SID. The domain DNS name portion can be excluded, in which case Data Governance Edition will infer what it can. For built-in accounts, a missing DNS name means that all of the instances of the provided SID must be excluded. |
DataUnderGovernance |
(Optional) Specify this parameter if you want to include only governed resources in your query. If this parameter is not specified, the query will include all resources. |
Examples:
Example | Description |
---|---|
Get-QAccountAccess -ManagedHostId 72eed1b9-bf06-4bb9-9ac4-1886daafc514 -TargetId 6a894591-f707-41e5-a187-6b379d07c043 -ResType Folders -AccountOrigin xdomain.local -TargetType Employee -Direct $true |
Looks at a managed host with id 72eed1b9-bf06-4bb9-9ac4-1886daafc514. The account or trustee in question has a SID of 6a894591-f707-41e5-a187-6b379d07c043, its type is Employee and the resource type is folders. |
Details retrieved:
Detail | Description |
---|---|
RightType | The access right type. |
ItemResourceType | The resource type. |
ResourceURI | The URI of the resource to which the trustee has access. |
TrusteeDisplayName | The display name of the trustee. |
TrusteeSid | The SID assigned to the account (trustee). |
HostName | The host where the resource resides. |
Rights | The specific access rights assigned. |
AppliesTo | What the rights apply to. |
Inheritance | The type of inheritance. |