Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Rule Methods › Agent Method—Sets or Retrieves an Agent Object or an Agent Group Object Associated with the Global Rule

Agent Method—Sets or Retrieves an Agent Object or an Agent Group Object Associated with the Global Rule

The Agent method sets or retrieves an agent object or an agent group object associated with the global rule.

Syntax

The Agent method has the following format:

Netegrity::PolicyMgtRule‑>Agent(agentObject)

Parameters

The Agent method accepts the following parameter:

agentObject (objectType)

Specifies the agent object or agent group object to associate with the rule. objectType can be either PolicyMgtAgent or PolicyMgtGroup.

Return Value

The Agent method returns a new or existing PolicyMgtAgent object or PolicyMgtGroup object.

Remarks

After the rule is created, the agent associated with the rule can be changed only within the same agent type (such as Web Agent).

Note: Rules that have domain scope are associated with agents indirectly, through a realm.