Chat now with support
Chat with Support

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

Introduction Resource access requests Share creation requests Appendix: PowerShell commands

Name pattern resolver management

A name pattern resolver is a variable that is resolved at run time in the context of the request to create a new managed resource during the Data Governance Administrator's approval process. These variables are listed on the Group Name dialog and can be added to the group naming pattern to dynamically construct unique Active Directory group names for the new managed resources.

TIP: Prior to adding or modifying a name pattern resolver, see Name pattern resolvers for an overview of this feature.

The following commands are available to manage your name pattern resolvers, which are used in file system share creation requests in the IT Shop. For full parameter details and examples, click a command in the table or see the command help, using the Get-Help command.

Table 51: Name pattern resolver management commands

Use this command

If you want to

Add-QNamePatternResolver

Add a name pattern resolver to the Data Governance Edition deployment.

Get-QNamePatternResolver

Retrieve a name pattern resolver from the Data Governance Edition deployment.

NOTE: You can retrieve a specific name pattern resolver or a list of all name pattern resolvers (variables) in the database.
Remove-QNamePatternResolver Remove a name pattern resolver (variable) from the Data Governance Edition deployment.
Set-QNamePatternResolver Update an existing name pattern resolver in the Data Governance Edition deployment.

Add-QNamePatternResolver

Adds a name pattern resolver to the Data Governance Edition deployment.

A name pattern resolver is a variable that is resolved at run time in the context of the request to create a new managed resource. These variables can be added to the group naming pattern to dynamically construct unique Active Directory group names for the new managed resources.

Syntax:

Add-QNamePatternResolver -NamePatternVariable <String> -DialogScriptID <String> [<CommonParameters>]

Table 52: Parameters
Parameter Description
NamePatternVariable

Specify the variable to be specified in the group naming pattern.

For the "random number" variable, this is "random".

DialogScriptID

Specify the value assigned to the script that will be run to resolve the variable.

For the "random number" variable, this is "QAM-6F86A9F78B1A0144A01EACEE3B4F54B3".

Examples:
Table 53: Examples
Example Description
Add -QNamePatternResolver -NamePatternVariable "CurrentDate" -DialogScriptID "QAM-5E75A8E58B0A00FABDD2A3E43A2" Adds a new name pattern resolver, CurrentDate, to the Data Governance Edition deployment.

Get-QNamePatternResolver

Retrieves a name pattern resolver from the Data Governance Edition deployment.

Syntax:

Get-QNamePatternResolver [-Id [<String>]] [<CommonParameters>]

Table 54: Parameters
Parameter Description
Id

(Optional) Specify the ID (GUID format) of a name pattern resolver to retrieve.

If this parameter is not specified, all name pattern resolvers in the database are returned.

Examples:
Table 55: Examples
Example Description
Get-QNamePatternResolver Returns a list of all name pattern resolvers in the database.
Get-QNamePatternResolver -Id 3b2a26da-a024-430f-adaa-3dbe5265cf5b Returns information on the specified name pattern resolver.
Details retrieved:
Table 56: Details retrieved
Detail Description (Associated key or property in QAMNamePatternResolver table)
Variable The variable to be specified in a group naming pattern (NamePatternVariable).
DialogScriptID The value assigned to the name pattern resolver script when it is created (UID_DialogScript).
Id The value (GUID) assigned to the name pattern resolver (UID_QAMNamePatternResolver).

Remove-QNamePatternResolver

Removes a name pattern resolver from the Data Governance Edition deployment.

Syntax:

Remove-QNamePatternResolver -Id <String> [<CommonParameters>]

Table 57: Parameters
Parameter Description
Id

Specify the ID (GUID format) of the name pattern resolver to be removed.

NOTE: Run the Get-QNamePatternResolver cmdlet without any parameters to retrieve a list of available name pattern resolvers and associated IDs.
Examples:
Table 58: Examples
Example Description
Remove -QNamePatternResolver -Id 7c8dd75a-c42e-43f8-8c60-72c1a9050b6c Removes the specified name pattern resolver from the database.
Related Documents