Chat now with support
Chat mit 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

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

Use this command

If you want to

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.

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

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
Parameter Description
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
Example Description
Get-QManagedResourceFunction Retrieves a list of all managed resource function records found in the database.
Details retrieved:
Table 96: Details retrieved
Detail Description (Associated key or property in QAMManagedResourceFunction table)
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
Parameter Description
Id

Specify the ID (GUID format) of the managed resource function to be removed.

Examples
Table 98: Examples
Example Description
Remove-QManagedResourceFunction -Id e39946d5-1397-43a7-972a-7557c5511234 Removes the specified managed resource function from the database,
Verwandte Dokumente