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

最終公開日 : Nov 13, 2026
Workspace Environment Management™ には、XML プリンターリストファイルを使用してユーザープリンターを構成する機能が含まれています。
XML プリンターリストファイルを作成したら、管理コンソールで Action Type オプションを Use Device Mapping Printers File に設定して、プリンターアクション を作成します。
注:
特定の 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<string, List&lt;VUEMUserAssignedPrinter>>>
各デバイスは次のように表されます。
    <SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
        <Key>DEVICE1</Key>
        <Value>
            <VUEMUserAssignedPrinter>
               ...
            </VUEMUserAssignedPrinter>
        </Value>
    </SerializableKeyValuePairOfStringListOfVUEMUserAssignedPrinter>
各デバイスブロックは、特定のクライアントまたはコンピューター名と一致している必要があります。\&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>

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 Agent Hostによって認識されるプリンター名です。このフィールドは空白にできません。
\&lt;Description>. これは、Workspace Environment Management Agent Hostによって認識されるプリンターの説明です。このフィールドは空白にできます。
\&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(デフォルトプリンター)
  • Canon C5531i Series プリンター(UNC パス \\server.example.net\Canon C5531i Series 上)
また、クライアントまたはコンピューター DEVICE2 にアクティブなプリンターを 1 台割り当てます。
  • HP LaserJet 2200 Series(UNC パス \\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>