Get-QSelfServiceMethodsToSatisfyRequest
Returns the group membership that satisfies a resource access request. Use this command to simulate the "best fit" calculation to see what groups are returned if you request read or read and write access to a specific resource.
Note: This PowerShell cmdlet does not support NFS or Cloud resources (since these types of resources cannot be published to the IT Shop).
Syntax:
Get-QSelfServiceMethodsToSatisfyRequest [-Path] <String> [-DomainName] <String> [-ActionIdentifier] <String> [[-ClientCulture] [<String>]] [[-ResourceTypeString] [<String>]] [<CommonParameters>]
Table 9: Parameters
Path |
Specify the path of the resource. |
DomainName |
Specify the name of the domain where the resource is located. |
ActionIdentifier |
Specify the type of self-service action:
- RequestReadAccess: Use this option if you want read access to items within a folder.
- RequestChangeAccess: Use this option if you want read and write access to items within a folder.
|
ClientCulture |
(Optional) Set the client culture. |
ResourceTypeString |
(Optional) Specify the type of resource for which to request access:
- NTFS\Folder
- NTFS\File
- Windows\Computer\Share
- SharePoint\Site
- SharePoint\Folder
- SharePoint\List
- SharePoint\ListItem
- SharePoint\ResourceItem
|
Examples:
Table 10: Examples
Get-QSelfServiceMethodsToSatisfyRequest -Path "\\2K8RDJSQL\CS\Test Data\Email_Addresses.txt" -DomainName VMSET6 -ActionIdentifier "RequestReadAccess" -ResourceTypeString NTFS\File |
Returns the groups that satisfy the "RequestReadAccess" request for a NTFS/File. |
Managed resource information
These commands are available to retrieve the following information about a managed resource.
- Managed group: A managed group is an Active Directory group created by the Data Governance Edition deployment in order to control access to a managed resource, such as a file share.
- Managed resource: A managed resource is a type of resource, such as a file share, that was created by the Data Governance deployment.
- Managed resource/DuG mapping: A managed resource/DuG mapping object correlates a managed resource to any QAMDuG object it links to.
For full parameter details and examples, click a command in the table or see the command help, using the Get-Help command.
Table 11: Managed resource information commands
Get-QManagedGroup |
Retrieve a managed group from the Data Governance Edition deployment.
You can retrieve a specific managed group or a list of all managed groups in the database. |
Get-QManagedResource |
Retrieve a managed resource from the Data Governance Edition deployment.
You can retrieve a specific managed resource or a list of all managed resources in the database. |
Get-QManagedResourceDuG |
Retrieve a managed resource/DuG mapping object from the Data Governance Edition deployment.
You can retrieve a specific managed resource/DuG mapping object or a list of all managed resource/DuG mapping objects in the database. |
Get-QManagedGroup
Retrieves details about a managed group from the Data Governance Edition deployment.
Syntax:
Get-QManagedGroup [-Id [<String>]] [<CommonParameters>]
Table 12: Parameters
Id |
(Optional) Specify the ID (GUID format) of the managed group to be retrieved.
If this parameter is not specified, all managed groups in the database are returned. |
Examples:
Table 13: Examples
Get-QManagedGroup |
Returns all managed groups in the database. |
Get-QManagedGroup -Id fe59f287-8177-46e8-9cae-71b3b455ee3e |
Returns information on the specified managed group. |
Details retrieved:
Table 14: Details retrieved
GroupName |
The name assigned to the group when it was created (OriginalGroupName). |
ADSGroupID |
The value (GUID) assigned to the ADS group (UID_ADSGroup). |
ManagedGroupTemplateID |
The value (GUID) assigned to the managed group template (UID_QAMManagedGroupTemplate). |
ManagedResourceID |
The value (GUID) assigned to the managed resource (UID_QAMManagedResource). |
Id |
The value (GUID) assigned to the managed group (UID_QAMManagedGroup). |
Get-QManagedResource
Retrieves details about a managed resource that was created by Data Governance Edition.
Syntax:
Get-QManagedResource [-Id [<String>]] [<CommonParameters>]
Table 15: Parameters
Id |
(Optional) Specify the ID (GUID format) of the managed resource to be retrieved.
If this parameter is not specified, all managed resources in the database are returned. |
Examples:
Table 16: Examples
Get-QManagedResource |
Returns a list of all managed resources in the database. |
Get-QManagedResource -Id c0bc3da4-f660-4e18-8b14-a945c7a6be69 |
Returns information on the specified managed resource. |
Details retrieved:
Table 17: Details retrieved
Name |
The name assigned to the managed resource (Name). |
BusinessOwnerIDObjectKey |
The value assigned to the business owner (ObjectKeyBusinessOwner). |
ManagedResourceTypeID |
The value (GUID) assigned to the managed resource type (UID_QAMManagedResourceType). |
QAMNodeID |
The value (GUID) assigned to the QAMNode (UID_QAMNode). |
Id |
The value (GUID) assigned to the managed resource (UID_QAMManagedResource). |