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
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.
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
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
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
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
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
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
Id |
Specify the ID (GUID format) of the name pattern resolver to be removed.
Run the Get-QNamePatternResolver cmdlet without any parameters to retrieve a list of available name pattern resolvers and associated IDs. |
Examples:
Table 58: Examples
Remove -QNamePatternResolver -Id 7c8dd75a-c42e-43f8-8c60-72c1a9050b6c |
Removes the specified name pattern resolver from the database. |