Workspace Environment Management includes the ability to configure user printers via an XML printer list file.
After you have created an XML printer list file, create a
printer action
in the administration console with an
Action Type
option set to
Use Device Mapping Printers File
.
Note:
Only printers that do not require specific Windows credentials are supported.
XML printer list file structure
The XML file is encoded in UTF-8, and has the following basic XML structure:
Each block of devices must be matched to a specific client or computer name. The <Key> tag contains the relevant name. The <Value> tag contains a list of VUEMUserAssignedPrinter objects matching the printers assigned to the specified client.
Each configured printer must be defined in a <VUEMUserAssignedPrinter> tag, using the following attributes:
<IdPrinter>. This is the Workspace Environment Management printer ID for the configured printer. Each printer must have a different ID. Note The XML Printer List action configured in the Workspace Environment Management Administration Console is also a printer action with its own ID which must be different from the ID of printers individually configured in the XML list.
<IdSite>. Contains the site ID for the relevant Workspace Environment Management site, which must match the ID of an existing site.
<State>. Specifies the state of the printer where 1 is active and 0 is disabled.
<ActionType>. Must always be 0.
<UseExtCredentials>. Must be 0. The use of specific Windows credentials is not currently supported.
<isDefault>. If 1, printer is the default Windows printer. If 0, it is not configured as default.
<IdFilterRule>. Must always be 1.
<RevisionId>. Must always be 1. If printer properties are later modified, increment this value by 1 to notify the Agent Host and ensure the printer action is reprocessed.
<Name>. This is the printer name as perceived by the Workspace Environment Management Agent Host. This field cannot be left blank.
<Description>. This is the printer description as perceived by the Workspace Environment Management Agent Host. This field can be blank.
<DisplayName>. This is unused and should be left blank.
<TargetPath>. This is the UNC path to the printer.
<ExtLogin>. Contains the name of the Windows account used when specifying Windows credentials for connection. [Currently unsupported. Leave this field blank.].
<ExtPassword>. Contains the password for the Windows account used when specifying Windows credentials for connection. [Currently unsupported. Leave this field blank.].
<Reserved01>. This contains advanced settings. Do not alter it in any way.