Managed resource function management
A managed resource function contains mappings between arbitrary logical functions and the scripts that implement them. These functions can be used by the approval and creation process for a managed resource.
The default managed resource functions provided include:
- LocateFileOperationsJobServer: Default processor for locating a job server that can process new shares and file paths when creating a new managed resource.
- ResolveADContainer: Default processor for locating an Active Directory container ID for use when creating new managed resource groups.
- SetRestrictionList: Restriction list processing subroutine for managed resource creation.
TIP: Prior to adding, removing or modifying a managed resource function, see Managed resource functions for an overview of this feature.
The following commands are available to manage your managed resource functions, which are used in file system share 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 91: Managed resource function management commands
| Add-QManagedResourceFunction |
Add a new managed resource function to the Data Governance Edition deployment. |
| Get-QManagedResourceFunction |
Retrieve a specific or all managed resource function records from the Data Governance Edition deployment.
You can retrieve a specific managed resource function or a list of all managed resource function records in the database. |
| Remove-QManagedResourceFunction |
Remove a managed resource function from the Data Governance Edition deployment. |
| Set-QManagedResourceFunction |
Update an existing managed resource function in the Data Governance Edition deployment. |
Add-QManagedResourceFunction
Adds a new managed resource function to the Data Governance Edition deployment.
Note: Adding a new managed resource function will not change how the current default process works. To use a newly created managed resource function requires you to create a new process chain to call the new function or subroutine.
Syntax:
Add-QManagedResourceFunction -Name <String> [-Description [<String>]] -ManagedResourceTypeID <String> -DialogScriptID <String> [<CommonParameters>]
Table 92: Parameters
| Name |
Specify the name of the new managed resource function. |
| Description |
(Optional) Enter a brief description for the new managed resource function. |
| ManagedResourceTypeID |
Specify the value (GUID) assigned to the managed resource type associated with the new managed resource function. |
| DialogScriptID |
Specify the value assigned to the predefined script associated with the new managed resource function. |
Examples
Table 93: Examples
|
Add-QManagedResourceFunction -Name "MyFunction" -ManagedResourceTypeID 7ade8b8d-a400-4fb1-ab826d424feeb63e -DialogScriptID "QAM-2B2A19808659A444B94932679D601234" |
Adds a new managed resource function named "MyFunction" for the managed resource type with the GUID 7ade8b8d-a400-4fb1-ab826d424feeb63e, and associates it with the QAM-2B2A19808659A444B94932679D601234 script. |
Get-QManagedResourceFunction
Retrieves a specific or all managed resource function records found in the Data Governance Edition deployment.
Syntax:
Get-QManagedResourceFunction [-Id [<String>]] [<CommonParameters>]
Table 94: Parameters
| Id |
(Optional) Specify the value (GUID format) of the managed resource function to retrieve.
If this parameter is not specified, all managed resource function records in the database are returned. |
Examples:
Table 95: Examples
| Get-QManagedResourceFunction |
Retrieves a list of all managed resource function records found in the database. |
Details retrieved:
Table 96: Details retrieved
| Name |
The name of the managed resource function. |
| Description |
The description entered when the managed resource function was created. |
| ManagedResourceTypeID |
The value (GUID) assigned to the resource type associated with the managed resource function (UID_QAMManagedResourceType). |
| DialogScriptID |
The value assigned to the script called by the managed resource function (UID_DialogScript). |
| Id |
The value (GUID) assigned to the managed resource function (UID_QAMManagedResourceFunction). |
Remove-QManagedResourceFunction
Removes a managed resource function record from the Data Governance Edition deployment.
Note: Do NOT remove the predefined managed resource functions provided. Removing any of these managed resource functions prevents the existing process chain from working.
Syntax:
Remove-QManagedResourceFunction -Id <String> [<CommonParameters>]
Table 97: Parameters
| Id |
Specify the ID (GUID format) of the managed resource function to be removed. |
Examples
Table 98: Examples
| Remove-QManagedResourceFunction -Id e39946d5-1397-43a7-972a-7557c5511234 |
Removes the specified managed resource function from the database, |
