Platform Deployment Guide › Technical Information › Export, Import and Copy Policies › Wgnpol.exe Command Line Syntax › wgnpol.exe - <Policy>

wgnpol.exe - <Policy>

This is the account name for the user, group, or machine whose policy you want to operate on. If you have duplicate group names, you may also need to specify the policy path. (For example, your CA DataMinder installation may include two 'Sales' subgroups, one in the 'Asia' group and the other in the 'Europe' group.)

Policy Names and Paths

When specifying a policy name or path:

• Policy names and paths are not case-sensitive.
• If a machine, group or user name includes spaces, you must enclose the entire path in double quotes.
• Use / separators to specify a policy path, for example, "Sales/North America/Canada".
• Wgnpol.exe does not recognize the backslash \ as a policy path separator. But backslashes are allowed in user names, such as unipraxis\lyndasteel.

All exported policy files contain a comment tag:

<!--Name: YourPolicyName-->

You can configure wgnpol.exe to read the original policy name from this comment in an exported policy file. To do this, replace the policy name with an asterisk (*) in the command line. For example, to import the Sales.xml policy file back into its original group, run:

wgnpol import * -f Sales.xml

Users and Groups

When specifying the account name for a user or group:

• If the top level user group has not been renamed (by default, 'Users'), type usermaster to specify its policy. If it has been renamed (for example, to 'All Unipraxis users'), you specify its policy by typing its new name in the normal way.
• The policy path root is the management group of the CMS logon account. When you run wgnpol.exe, you must provide a logon account for the CMS. Wgnpol.exe takes the management group defined for this account as the root of the policy path.

Machines

To specify an account name for:

• Common client, use machinecommonclient
• Common gateway, use machinecommongateway
• CMS, use <CMS machine name>
• Utility machine, <utility machine name>

<List Setting> or <Policy node>

For implist or impsetting operations, you must specify the target policy setting that will receive the imported items. There are three alternative methods for specifying the target setting:

• Reserved keywords: For outgoing emails, the reserved keywords searchtext1, searchtext2 and searchtext3 refer respectively to the Included Search Text list setting in the Search Text 1, 2 and 3 control triggers.
• Policy path based on folder and setting display names: In the CA DataMinder Policy Editor screen, the status bar shows the policy path of the folder or setting currently selected, based on the folder and setting display names (the names shown in the policy tree, not the underlying XML node names). You can use these display names to specify the target setting for an import operation.
• Policy path based on XML node names: You can use the XML node names within policy files to specify a setting.

More information:

Wgnpol.exe Examples