XMLプリンターリストの構成

最終公開日 : Nov 13, 2026
Workspace Environment Management™には、XMLプリンターリストファイルを使用してユーザープリンターを構成する機能が含まれています。
XMLプリンターリストファイルを作成したら、管理コンソールでアクションタイプオプションをデバイスマッピングプリンターファイルを使用に設定して、プリンターアクションを作成します。
注:
特定のWindows資格情報を必要としないプリンターのみがサポートされています。

XMLプリンターリストファイルの構造

XMLファイルはUTF-8でエンコードされており、以下の基本的なXML構造を持っています。
<?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>
すべてのクライアントと関連デバイスは、以下のタイプのオブジェクトによって表されます。
SerializableKeyValuePair&lt;string, List&lt;VUEMUserAssignedPrinter>>>
各デバイスは次のように表されます。
    <SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
        <Key>DEVICE1</Key>
        <Value>
            <VUEMUserAssignedPrinter>
               ...
            </VUEMUserAssignedPrinter>
        </Value>
    </SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
注:
エージェントがシングルセッションまたはマルチセッションOSにインストールされている場合:
  • クライアントは、エージェントホストに接続するクライアントデバイスを指します。
  • コンピューターとクライアントリモートは、エージェントホストを指します。
各デバイスブロックは、特定のクライアント名またはコンピューター名に一致させる必要があります。\&lt;Key>タグには関連する名前が含まれます。\&lt;Value>タグには、指定されたクライアントに割り当てられたプリンターに一致するVUEMUserAssignedPrinterオブジェクトのリストが含まれます。
    <?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>
注:
WEMエージェントがXMLプリンターリストファイルにアクセスできるようにするには、XMLプリンターリストファイルはローカルマシンまたは共有ネットワークリソースに保存する必要があります。

VUEMUserAssignedPrinterタグの構文

各構成済みプリンターは、以下の属性を使用して**\&lt;VUEMUserAssignedPrinter>**タグで定義する必要があります。
\&lt;IdPrinter>. これは、構成されたプリンターのWorkspace Environment ManagementプリンターIDです。各プリンターは異なるIDを持つ必要があります。注 Workspace Environment Management管理コンソールで構成されたXMLプリンターリストアクションも、独自のIDを持つプリンターアクションであり、XMLリストで個別に構成されたプリンターのIDとは異なる必要があります。
\&lt;IdSite>. 関連するWorkspace Environment ManagementサイトのサイトIDが含まれます。これは既存のサイトのIDと一致する必要があります。
\&lt;State>. プリンターの状態を指定します。1はアクティブ、0は無効です。
\&lt;ActionType>. 常に0である必要があります。
\&lt;UseExtCredentials>. 0である必要があります。特定のWindows資格情報の使用は現在サポートされていません。
\&lt;isDefault>. 1の場合、プリンターはデフォルトのWindowsプリンターです。0の場合、デフォルトとして構成されていません。
\&lt;IdFilterRule>. 常に1である必要があります。
\&lt;RevisionId>. 常に1である必要があります。プリンターのプロパティがさらに変更された場合は、この値を1増やしてエージェントホストに通知し、プリンターアクションが再処理されるようにします。
\&lt;Name>. これは、Workspace Environment Managementエージェントホストによって認識されるプリンター名です。このフィールドは空白にすることはできません。
\&lt;Description>. これは、Workspace Environment Managementエージェントホストによって認識されるプリンターの説明です。このフィールドは空白にできます。
\&lt;DisplayName>. これは使用されておらず、空白のままにする必要があります。
\&lt;TargetPath>. このパスは、プリンターへのUNCパスです。
\&lt;ExtLogin>. 接続用のWindows資格情報を指定する際に使用されるWindowsアカウント名が含まれます。。
\&lt;ExtPassword>. 接続用のWindows資格情報を指定する際に使用されるWindowsアカウントのパスワードが含まれます。。
\&lt;Reserved01>. これには詳細設定が含まれています。いかなる方法でも変更しないでください。
&gt;&lt;VUEMActionAdvancedOption&gt;&lt;Name&gt;SelfHealingEnabled&lt;/Name&gt;&lt;Value&gt;0&lt;/Value&gt;&lt;/VUEMActionAdvancedOption
特定のプリンターオブジェクトの自己修復をアクティブにするには、上記のコンテンツをコピーして貼り付け、ハイライトされた 0 の値を 1 に変更するだけです。

プリンターオブジェクトの例

次の例では、クライアントまたはコンピューター DEVICE1 に2つのアクティブなプリンターを割り当てます。
  • UNCパス \\server.example.net\HP LaserJet 2200 Series 上の HP LaserJet 2200 Series (既定のプリンター)
  • UNCパス \\server.example.net\Canon C5531i Series 上の Canon C5531i Series プリンター
また、クライアントまたはコンピューター DEVICE2 に1つのアクティブなプリンターを割り当てます。
  • UNCパス \\server.example.net\HP LaserJet 2200 Series 上の 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>