Chat now with support
Chat with Support

Identity Manager Data Governance Edition 8.0 - IT Shop Resource Access Requests User Guide

Introduction Resource access requests Share creation requests Appendix: PowerShell commands About us

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
Parameter Description
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
Example Description
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

Use this command

If you want to
Get-QManagedGroup

Retrieve a managed group from the Data Governance Edition deployment.

NOTE: 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.

NOTE: 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.

NOTE: 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
Parameter Description
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
Example Description
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
Detail Description (Associated key or property in QAMManagedGroup table)
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
Parameter Description
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
Example Description
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
Detail Description (Associated key or parameter in QAMManagedResource table)
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).
Related Documents