アプリケーション定義ファイルの構造

August 29, 2026

寄稿者:

C C

この記事では、Profile Managementアプリケーション定義ファイルのXML構造について説明します。この構造は、アプリケーションプロファイラーとクロスプラットフォーム設定の両方に適用されます。

アーキテクチャ図

アーキテクチャ図(/en-us/profile-management/2209/media/definitionfilestructure.jpg)

XML宣言とエンコーディング属性

XML宣言では、属性<?xml version=”1.0”>を指定する必要があります。

Encoding=”UTF-8”は推奨される属性です。
GroupDefinitions

グループのコレクションのコンテナです。XMLドキュメントのルート要素として機能します。その属性には、バージョンとGUIDが含まれます。これらは必須属性です。
グループ

サブアプリケーションの設定を定義します。その属性はnameとGUIDです。これらは必須属性です。
オブジェクト

サブアプリケーションの1つの設定を定義します。その属性はnameとGUIDです。これらは必須属性です。
プラットフォーム

Platformは、異なるオペレーティングシステムで異なる定義を提供します。オプションの属性OSVersionNumberを使用してオペレーティングシステムを指定できます。属性がない場合、すべてのプラットフォームが設定の内部定義を受け入れます。Platformには、RegKey、RegValue、File、Folder、Wallpaperのいずれかの要素が含まれている必要があります。
RegKey

レジストリ内のキーとして設定を定義します。Key要素を含める必要があります。オプションのサブ要素として、RecurseとMergeの2つが含まれます。RecurseとMergeは、Profile Managementがキーをローミングする際のパフォーマンスを定義します。もう1つのオプションのサブ要素はExcludeValuesです。ExcludeValuesは、除外できるレジストリ値を定義します。
RegValue

レジストリ内の値として設定を定義します。親キーのパスを指定するためにKeyを含める必要があります。
フォルダー

設定をフォルダーとして定義します。フォルダーのパスを指定するためにPathを含める必要があります。オプションのサブ要素として、RecurseとMergeがあります。RecurseとMergeは、Profile Managementがフォルダーをローミングする際のパフォーマンスを定義します。もう1つのオプションのサブ要素はExcludeFilesで、これは除外できるファイルを定義します。
ファイル

設定をファイルとして定義します。親フォルダーのパスを指定するためにPathを、ファイル名を指定するためにFileNameを含める必要があります。
壁紙

すべての壁紙設定を定義します。属性やサブ要素は必要ありません。Profile Managementはこれらの設定を自動的にローミングします。
Key

レジストリキーのパス、または親レジストリキーのパスを指定します。KeyはRegKeyとRegValueのサブ要素です。
ValueName

レジストリ値の名前を指定します。RegValueのサブ要素です。
パス

フォルダーのパスまたは親フォルダーのパスを指定します。これはFolderとFileのサブ要素です。Profile Management変数を採用できます。
FileName

ファイルの名前を指定します。これはFileのサブ要素です。
再帰

RegKeyとFolderのオプションのサブ要素です。この要素が存在する場合、Profile Managementはキーとフォルダーを再帰的にローミングします。
マージ

RegKeyとFolderのオプションのサブ要素です。この要素が存在する場合、Profile Managementはキーとフォルダーをマージします（ただし、置換はしません）。
ExcludeValues

RegKeyのオプションのサブ要素です。キーをローミングする際に除外できる値を指定します。
ExcludeFiles

Folderのオプションのサブ要素です。フォルダーをローミングする際に除外できるファイルを指定します。
除外

ExcludeValuesとExcludeFilesのサブ要素です。ファイルまたはレジストリ値の除外項目を指定します。

注

ドキュメントに正しい構文形式が含まれていることを確認してください。Profile Managementは、これらのファイルがロードされる際に、CPSValidationSchema.xsd検証ファイルを使用してこれらのファイルをチェックします。検証ファイルはProfile Managementのインストールパスの下にあります。Profile Managementは不正なファイルを無視し、エラーメッセージをログに記録します。

サンプル

<?xml version="1.0" encoding="UTF-8"?>

<!-- Copyright 2011 Citrix Systems, Inc. All Rights Reserved. -->

<GroupDefinitions GUID="748E63D3-426E-4796-9C32-420B25DB2D9F" Version="4.0.0.0">

<!-- Application Settings -->

<Group GUID="0FCCCF29-0A0E-482d-A77E-3F39A8A854A6" Name="Application Settings">

<!-- Registry Key Setting Example -->

<Object GUID="637EC13C-2D47-4142-A8EB-3CEA6D53522A" Name="Software\Application\certain key">

<Platform>

<RegKey>

<Key>Software\Microsoft\Office\certain key</Key>

<Merge/>

<Recurse/>

<ExcludeValues>

<Exclude>excluded value 1</Exclude>

<Exclude>excluded value 2</Exclude>

<Exclude>excluded value 3</Exclude>

</ExcludeValues>

</RegKey>

</Platform>

</Object>

<!-- Registry Value Setting Example -->

<Object GUID="3C896310-10C4-4e5f-90C7-A79F4E653F81" Name="Software\Application\certain value">

<!-- Folder Setting Example -->

<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\setting folder">

<Platform>

<Folder>

<!-- We can use Citrix variable if necessary -->

<Path>!CTX_ROAMINGAPPDATA!\Application\setting folder</Path>

<Merge/>

<Recurse/>

<ExcludeFiles>

<Exclude>excluded file 1</Exclude>

<Exclude>excluded file 2</Exclude>

<Exclude>excluded file 3</Exclude>

</ExcludeFiles>

</Folder>

</Platform>

</Object>

<!-- File Setting Example -->

<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\file.txt">

<Platform>

<File>

<!-- We can use Citrix variable if necessary -->

<Path>!CTX_ROAMINGAPPDATA!\Application</Path>

<FileName>file.txt</FileName>

</File>

</Platform>

</Object>

<!-- Setting based on different OS -->

<Object GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6" Name="!CTX_ROAMINGAPPDATA!\Application\%osname%\folder">

<!-- Assuming that the folder locates differently when in different platforms -->

<Platform OSVersionNumber="6.1">

<!-- Win7 -->

<Folder>

<Path>!CTX_ROAMINGAPPDATA!\Application\Win7\folder</Path>

<Recurse/>

</Folder>

</Platform>

<Platform OSVersionNumber="10.0">

<!-- Win10 -->

<Folder>

<Path>!CTX_ROAMINGAPPDATA!\Application\Win10\folder</Path>

<Recurse/>

</Folder>

</Platform>

</Object>

</Group>

</GroupDefinitions>

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

アプリケーション定義ファイルの構造

August 29, 2026

寄稿者:

C C

August 29, 2026

寄稿者:

C C