XML-Druckerlistenkonfiguration

Last published : Nov 13, 2026
Workspace Environment Management™ bietet die Möglichkeit, Benutzerdrucker über eine XML-Druckerlistendatei zu konfigurieren.
Nachdem Sie eine XML-Druckerlistendatei erstellt haben, erstellen Sie in der Verwaltungskonsole eine Druckeraktion mit der Option Aktionstyp auf Gerätezuordnungs-Druckerdatei verwenden festgelegt.
Hinweis:
Es werden nur Drucker unterstützt, die keine spezifischen Windows-Anmeldeinformationen erfordern.

Struktur der XML-Druckerlistendatei

Die XML-Datei ist in UTF-8 kodiert und hat die folgende grundlegende XML-Struktur:
<?xml version="1.0" encoding="UTF-8"?>

    <ArrayOfSerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    ...
    </ArrayOfSerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
Jeder Client und das zugehörige Gerät wird durch ein Objekt des folgenden Typs dargestellt:
SerializableKeyValuePair&lt;string, List&lt;VUEMUserAssignedPrinter>>>
Jedes Gerät wird wie folgt dargestellt:
    <SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
        <Key>DEVICE1</Key>
        <Value>
            <VUEMUserAssignedPrinter>
               ...
            </VUEMUserAssignedPrinter>
        </Value>
    </SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
Jeder Geräteblock muss einem bestimmten Client- oder Computernamen zugeordnet werden. Das Tag \&lt;Key> enthält den relevanten Namen. Das Tag \&lt;Value> enthält eine Liste von VUEMUserAssignedPrinter-Objekten, die den dem angegebenen Client zugewiesenen Druckern entsprechen.
    <?xml version="1.0" encoding="utf-8"?>

       <ArrayOfSerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
            <Key>DEVICE1</Key>
            <Value>
                <VUEMUserAssignedPrinter>
             ...
                </VUEMUserAssignedPrinter>
            </Value>
        </SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
       </ArrayOfSerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>

VUEMUserAssignedPrinter-Tag-Syntax

Jeder konfigurierte Drucker muss in einem Tag \&lt;VUEMUserAssignedPrinter> unter Verwendung der folgenden Attribute definiert werden:
\&lt;IdPrinter>. Dies ist die Workspace Environment Management-Drucker-ID für den konfigurierten Drucker. Jeder Drucker muss eine andere ID haben. Hinweis: Die in der Workspace Environment Management-Verwaltungskonsole konfigurierte XML-Druckerlistenaktion ist ebenfalls eine Druckeraktion mit einer eigenen ID, die sich von der ID der einzeln in der XML-Liste konfigurierten Drucker unterscheiden muss.
\&lt;IdSite>. Enthält die Site-ID für die relevante Workspace Environment Management-Site, die mit der ID einer vorhandenen Site übereinstimmen muss.
\&lt;State>. Gibt den Status des Druckers an, wobei 1 aktiv und 0 deaktiviert bedeutet.
\&lt;ActionType>. Muss immer 0 sein.
\&lt;UseExtCredentials>. Muss 0 sein. Die Verwendung spezifischer Windows-Anmeldeinformationen wird derzeit nicht unterstützt.
\&lt;isDefault>. Wenn 1, ist der Drucker der Standard-Windows-Drucker. Wenn 0, ist er nicht als Standard konfiguriert.
\&lt;IdFilterRule>. Muss immer 1 sein.
\&lt;RevisionId>. Muss immer 1 sein. Wenn Druckereigenschaften später geändert werden, erhöhen Sie diesen Wert um 1, um den Agent Host zu benachrichtigen und sicherzustellen, dass die Druckeraktion erneut verarbeitet wird.
\&lt;Name>. Dies ist der Druckername, wie er vom Workspace Environment Management Agent Host wahrgenommen wird. Dieses Feld darf nicht leer bleiben.
\&lt;Description>. Dies ist die Druckerbeschreibung, wie sie vom Workspace Environment Management Agent Host wahrgenommen wird. Dieses Feld kann leer bleiben.
\&lt;DisplayName>. Dies wird nicht verwendet und sollte leer gelassen werden.
\&lt;TargetPath>. Dies ist der UNC-Pfad zum Drucker.
\&lt;ExtLogin>. Enthält den Namen des Windows-Kontos, das bei der Angabe von Windows-Anmeldeinformationen für die Verbindung verwendet wird. .
\&lt;ExtPassword>. Enthält das Kennwort für das Windows-Konto, das bei der Angabe von Windows-Anmeldeinformationen für die Verbindung verwendet wird. .
\&lt;Reserved01>. Dies enthält erweiterte Einstellungen. Ändern Sie es nicht.
&gt;&lt;VUEMActionAdvancedOption&gt;&lt;Name&gt;SelfHealingEnabled&lt;/Name&gt;&lt;Value&gt;0&lt;/Value&gt;&lt;/VUEMActionAdvancedOption
Um die Selbstheilung für ein bestimmtes Druckerobjekt zu aktivieren, kopieren Sie einfach den obigen Inhalt und fügen Sie ihn ein, wobei Sie den hervorgehobenen Wert 0 in 1 ändern.

Beispiel für ein Druckerobjekt

Das folgende Beispiel weist dem Client oder Computer DEVICE1 zwei aktive Drucker zu:
  • HP LaserJet 2200 Series unter UNC-Pfad \\server.example.net\HP LaserJet 2200 Series (Standarddrucker)
  • Canon C5531i Series Drucker unter UNC-Pfad \\server.example.net\Canon C5531i Series
Es weist außerdem einen aktiven Drucker auf dem Client oder Computer DEVICE2 zu:
  • HP LaserJet 2200 Series unter UNC-Pfad \\server.example.net\HP LaserJet 2200 Series
<?xml version="1.0" encoding="utf-8"?>
  <ArrayOfSerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
        <Key>DEVICE1</Key>
        <Value>
            <VUEMUserAssignedPrinter>
                <IdPrinter>1</IdPrinter>
                <IdSite>1</IdSite>
                <State>1</State>
                <ActionType>0</ActionType>
                <UseExtCredentials>0</UseExtCredentials>
                <isDefault>1</isDefault>
                <IdFilterRule>1</IdFilterRule>
                <RevisionId>1</RevisionId>
                <Name>HP LaserJet 2200 Series</Name>
                <Description />
                <DisplayName />
                <TargetPath>\\server.example.net\HP LaserJet 2200 Series</TargetPath>
                <ExtLogin />
                <ExtPassword />
                <Reserved01>&lt;?xml version="1.0" encoding="utf-8"?&gt;&lt;ArrayOfVUEMActionAdvancedOption xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"&gt;&lt;VUEMActionAdvancedOption&gt;&lt;Name&gt;SelfHealingEnabled&lt;/Name&gt;&lt;Value&gt;0&lt;/Value&gt;&lt;/VUEMActionAdvancedOption&gt;&lt;/ArrayOfVUEMActionAdvancedOption&gt;</Reserved01>
            </VUEMUserAssignedPrinter>
        </Value>
      <Value>
            <VUEMUserAssignedPrinter>
                <IdPrinter>2</IdPrinter>
                <IdSite>1</IdSite>
                <State>1</State>
                <ActionType>0</ActionType>
                <UseExtCredentials>0</UseExtCredentials>
                <isDefault>0</isDefault>
                <IdFilterRule>1</IdFilterRule>
                <RevisionId>1</RevisionId>
                <Name>Canon C5531i Series</Name>
                <Description />
                <DisplayName />
                <TargetPath>\\server.example.net\Canon C5531i Series</TargetPath>
                <ExtLogin />
                <ExtPassword />
                <Reserved01>&lt;?xml version="1.0" encoding="utf-8"?&gt;&lt;ArrayOfVUEMActionAdvancedOption xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"&gt;&lt;VUEMActionAdvancedOption&gt;&lt;Name&gt;SelfHealingEnabled&lt;/Name&gt;&lt;Value&gt;0&lt;/Value&gt;&lt;/VUEMActionAdvancedOption&gt;&lt;/ArrayOfVUEMActionAdvancedOption&gt;</Reserved01>
            </VUEMUserAssignedPrinter>
        </Value></SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
      <SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
        <Key>DEVICE2</Key>
        <Value>
            <VUEMUserAssignedPrinter>
                <IdPrinter>1</IdPrinter>
                <IdSite>1</IdSite>
                <State>1</State>
                <ActionType>0</ActionType>
                <UseExtCredentials>0</UseExtCredentials>
                <isDefault>0</isDefault>
                <IdFilterRule>1</IdFilterRule>
                <RevisionId>1</RevisionId>
                <Name>HP LaserJet 2200 Series</Name>
                <Description />
                <DisplayName />
                <TargetPath>\\server.example.net\HP LaserJet 2200 Series</TargetPath>
                <ExtLogin />
                <ExtPassword />
                <Reserved01>&lt;?xml version="1.0" encoding="utf-8"?&gt;&lt;ArrayOfVUEMActionAdvancedOption xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"&gt;&lt;VUEMActionAdvancedOption&gt;&lt;Name&gt;SelfHealingEnabled&lt;/Name&gt;&lt;Value&gt;0&lt;/Value&gt;&lt;/VUEMActionAdvancedOption&gt;&lt;/ArrayOfVUEMActionAdvancedOption&gt;</Reserved01>
            </VUEMUserAssignedPrinter>
        </Value></SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
   </ArrayOfSerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>