Office 2010 の Config.xml ファイル

構文

<Configuration [Product="製品 ID"] >

   ...

</Configuration>

属性

備考

Product 属性は、この Config.xml ファイルの影響を受ける製品を特定します。製品 ID の定義は、製品のコア フォルダーにある Setup.xml ファイルの Setup 要素の ID 属性内で行われます。

Product 属性は省略できます。ただし、Display 要素 の Level 属性を "basic" または "none" に設定している場合を除きます。その場合は、Product 属性が必須になります。Product 属性で指定されている製品がネットワーク インストール ポイントに存在しなければ、セットアップはインストールを終了します。

例

Microsoft Office Professional Plus 2010 の製品 ID は、ProPlus.WW\Setup.xml 内の次の行にあります。

<Setup Id="ProPlus" Type="Product"  ... >

この 製品 ID を Config.xml で使用して Office Professional Plus 2010 を指定するには、次のように入力します。

<Configuration Product="ProPlus">
   ...
</Configuration>

構文

<AddLanguage

   Id="ll-cc" | "match"

   [ShellTransform="Yes"]

/>

属性

備考

言語はネットワーク インストール ポイントで利用できる必要があります。

複数の AddLanguage および RemoveLanguage 要素 を指定できます。RemoveLanguage 要素 と AddLanguage 要素の両方に同じ言語を指定した場合は、AddLanguage 要素が優先され、その言語のインストールが行われます。

Office 2010 のインストール時には、言語に関する次の 3 つの概念について理解しておく必要があります。

• セットアップのユーザー インターフェイス (UI): インストールの言語です。

• シェルの UI: ショートカット、右クリックのコンテキスト メニュー、およびツールヒントの言語です。

• Office の UI: Office のユーザー インターフェイスとメニューの言語です。

Office の言語が複数ある場合は、これら 3 つの値が以下のようにして決まります。

既定では、セットアップの UI が、インストールで使用可能なリソースのセットと、ユーザー ロケールとの一致が可能かどうかに依存します。セットアップの UI は、既定でユーザー ロケールに一致します。シェルの UI は、インストールされる言語のセットに依存し、既定ではセットアップの UI に従います。Office の UI の既定の言語は、ユーザー ロケールと現在のユーザー設定に依存します。既定では、各ユーザーのコンピューターに設定されている Windows ユーザー ロケールが使用されます。つまり、既定では、セットアップの UI、シェルの UI、および Office の UI がすべて同じになります。

Windows オペレーティング システムにおけるロケールとは、ユーザーの言語、環境、および文化的な慣習に関連した、一連のユーザー設定情報のことです。この情報は、値のリストとして表現され、適切な入力言語、キーボードのレイアウト、並べ替え順序、数字の形式、日付の形式、通貨の形式、および時間の形式を決めるのに使用されます。ユーザー ロケールは、日付、時間、通貨、および数字の表示に既定で使用される形式とテキストの並べ替えを決定するユーザー別の設定です。ユーザー ロケールの指定は、コンピューターで作成されるアカウントごとに行われます。

管理者が Config.xml ファイルでインストール用の言語を複数指定する場合は、シェルの UI の言語を、インストールされる言語のセットから選択する必要があります。そのために、管理者は Config.xml ファイルで AddLanguage 要素の ShellTransform 属性を指定します。AddLanguage 要素は、セットアップがシェルの UI で使用する言語を指定します。ただし、この設定は、ユーザーのコンピューターへのインストール時におけるセットアップの UI や Office の UI の選択に必ずしも影響するわけではありません。

たとえば、Office イメージが英語、フランス語、ドイツ語、およびスペイン語に対応している場合、セットアップによってこれらすべての言語の完全な言語サポートをインストールするように指定すると共に、シェルの UI がユーザーの既定の地域のオプションに従うようにするには、次の要素を Config.xml ファイルに追加します。

<AddLanguage Id="match" ShellTransform="yes"/> <AddLanguage Id="en-us" /> <AddLanguage Id="fr-fr" /> <AddLanguage Id="de-de" /> <AddLanguage Id="es-es" />

この例では、指定したすべての言語がセットアップによってインストールされ、シェルの UI はユーザーのロケールの言語に一致します。より多くの言語がソース イメージで使用できる場合、match の言語が明示的に呼び出された他の 4 つの言語のいずれにもならなければ、この例の match の値によって追加の言語がインストールされることがあります。たとえば、ソースに日本語も含まれているときには、ユーザーのロケールが日本語に設定されているコンピューターへのインストール時に、他の 4 つの言語に加えて日本語もインストールされます。

例

<AddLanguage Id="en-us" ShellTransform="Yes" />

構文

<ARP 属性**="値"** [属性**="値"**] ... />

属性

構文

<Command

   Path="パス"

   [QuietArg="引数"]

   [Args="引数"]

[ChainPosition="Before" | "After"(既定値)]

   [Wait="ミリ秒"]

[Execute="Install"(既定値) | "Uninstall"]

[Platform="x86"(既定値) | "x64"]

/>

属性

次の表は、Command 要素の属性について説明したものです。

備考

Config.xml ファイルの Command 要素と OCT の [インストール環境の追加とプログラムの実行] オプション ([プログラム エントリの追加] ダイアログ ボックスおよび [プログラム エントリの変更] ダイアログ ボックスで入力するコマンド ライン) は、製品の初回インストールおよびアンインストールでのみ使用できます。Command 要素のコマンドは、初回インストールおよびアンインストール時にのみ処理されます。初回インストール後に Command 要素のコマンドをカスタマイズに使用しても、コマンドは無視されます。

こうしたコマンド ラインを指定して、任意のコマンドを実行したり、この製品のインストール時に必要となる軽量な実行可能ファイルを実行したりできます。

Config.xml ファイルの Command 要素や OCT の [インストール環境の追加とプログラムの実行] オプションには、開発の進捗の追跡や問題のトラブルシューティングのような、エンタープライズ ソフトウェア展開および管理ツールに備わっているソフトウェア展開機能がありません。そのため、Config.xml ファイルにおける Command 要素や OCT の [インストール環境の追加とプログラムの実行] オプションの使用は、軽量な実行可能ファイルの実行や、コンピューターに対する変更が発生しないかユーザーによる入力を必要としない任意のコマンドの実行に制限することをお勧めします。たとえば、ログをコピーするユーティリティや、インストールの最後にウェルカム ページを表示するコマンドは、実行できます。

Args および QuietArg の使用法は、次のとおりです。

• Args 属性は、必ずコマンドに追加されます。これには、"/install" や "Company=<会社名>" のようなスイッチも含まれます。

• さらに QuietArg 属性が追加されるのは、サイレント セットアップの実行時 (Display が Display="none" のように設定されている場合) です。そうした場合は、QuietArg 属性に "/quiet" スイッチを指定できます。具体的には、QuietArg="/quiet" のように使用します。

以下では、Wait 属性について説明します。

• Wait 属性を 0 ミリ秒に設定すると、プログラムを実行してからインストールを続行するまでの待機時間がなくなります。この場合、コマンドは実行後直ちに処理を先へと進めます。

  リターン コードは、Wait の値が 0 でない場合にのみ意味を持ちます。値に 0 を指定した場合、セットアップは指定されたプログラムの実行後、待機することなくインストールを続行します。そのため、この場合はリターン コードによって返すべき情報がありません。

• Wait 属性に正の値を設定すると、その値をミリ秒数とした時間だけ待機が行われます。プロセスが指定の時間よりも早く終了した場合は、セットアップが続行されます。指定した時間が経過してもプロセスが終了しない場合、セットアップは失敗します。

• Wait 属性を -1 に設定すると、待機状態がいつまでも続くことになります。コマンド プロセスが応答を停止 (ハング) すると、セットアップも応答しなくなり、そのコマンドの実行をいつまでも待ち続けるので、この設定は問題を発生させる可能性があります。

Config.xml ファイルに複数の Command 要素がある場合は、Config.xml で指定されている順序で実行されます。

例

<Command Path="\\server\share\myscript.exe" Args='/id "123 abc"' QuietArg="/q" Wait="30000" />

構文

<COMPANYNAME Value="会社名" />

属性

例

<COMPANYNAME Value="Microsoft Corporation" />

構文

<Display

Level="None" | "Basic" | "Full"(既定値)

CompletionNotice="Yes" | "No"(既定値)

SuppressModal="Yes" | "No"(既定値)

NoCancel="Yes" | "No"(既定値)

AcceptEula="Yes" | "No"(既定値)

/>

属性

備考

この要素が定義されていない場合、既定の設定が使用されます。無効な値が指定されている場合は、セットアップはインストールを終了します。

Level 属性が "basic" または "none" に設定されており、PIDKEY 要素 を使用してプロダクト キーを指定した場合、セットアップは、管理者がユーザーの代わりに使用許諾契約書にも同意したものと見なします。

例

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="Yes" />

構文

<DistributionPoint Location="パス" />

属性

備考

この要素が指定されていない場合、セットアップは、Setup.exe ファイルがネットワーク インストール ポイントのルートに存在するものと見なします。

例

<DistributionPoint Location="\\server1\office" />

構文

<INSTALLLOCATION Value="パス" />

属性

備考

このパスでは、システム環境変数を使用できます。この要素が指定されていない場合、Office は %ProgramFiles%\Microsoft Office にインストールされます。

例

<INSTALLLOCATION Value="%ProgramFiles%\MyApps" />

構文

<LIS

[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]

[SOURCELIST="セミコロン区切りのパス リスト"]

/>

属性

備考

既定では、Office のインストール先のドライブのルートにある \MsoCache\All Users フォルダーに LIS が作成されます。ネットワーク インストール ポイントの Updates フォルダーにあるセットアップ カスタマイズ ファイルおよびソフトウェアの更新プログラムもコピーされます。

INSTALLLOCATION 要素 を指定した場合は、LIS の作成先ドライブの決定にパスのドライブ指定が使用されます。たとえば、INSTALLLOCATION 要素 のパスが E:\office\files であれば、LIS は E ドライブに作成されます。SOURCELIST 属性に列挙されたソースは、インストールされた製品と共に保存され、ユーザーのコンピューター上のローカル インストール ソース (LIS) が見つからないときや壊れたときに、セットアップによって使用されます。

例

<LIS CACHEACTION="CacheOnly" />   
<LIS SOURCELIST="\\server1\office;\\server2\corpdata" />

構文

<Logging

Type="Off" | "Standard"(既定値) | "Verbose"

   Path="パス"

   Template="<ファイル名>.txt"

/>

属性

備考

Template 値の任意の場所に * を指定できます。セットアップは、その場所に次の形式で文字列を挿入します。

YYYYMMDDHHMMSS xxx

各部分の意味は次のとおりです。

1. YYYY = 年

2. MM = 月

3. DD = 日

4. HH = 時

5. MM = 分

6. SS = 秒

7. xxx = セットアップによって生成される一意の文字列

例

<Logging Type="standard" Path="%temp%" 
   Template="MyLog(*).txt" 
/>

この例では、セットアップによるログ ファイルの作成が製品のインストールごとに行われます。セットアップは、次のような固有のファイル名を使用します。

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

構文

<MinOSRequirement

   VersionNT="バージョン"

   WindowsBuild="番号"

   ServicePackLevel="番号"

/>

属性

以下の値を使用できます。

備考

ユーザーのコンピューターのオペレーティング システムがここで指定されたバージョン (この要素が指定されていない場合は Office の既定値) よりも前のバージョンであれば、セットアップはインストールを続行しません。Office 2010 で必要とされるバージョンよりも前のバージョンの Windows は、ここには指定できません。

システム要件の詳細については、「Office 2010 の IT 担当者向け新機能」を参照してください。

構文

<OptionState

   Id="optionID"

   State="Absent" | "Advertise" | "Local"

   [Children="force"]

/>

属性

備考

機能は、ユーザーがインストールすることを選択できるアイテムです。機能の Id 値は、コア製品フォルダーにある Setup.xml ファイルの Option 要素で定義されます。

例

<OptionState Id="ExcelAddinFiles" 
   State="Absent" 
   Children="force" 
/>

構文

<PIDKEY Value="25 文字のキー" />

属性

備考

PIDKEY 値が設定されている場合、ユーザーは Office をインストールするときにプロダクト キーを入力する必要がありません。

Config.xml ファイルに MAK キーを入力するには、ファイル中に次の行を追加します。

<PIDKEY Value="AAAAABBBBBCCCCCDDDDDEEEEE" />

AAAAABBBBBCCCCCDDDDDEEEEE は 25 文字のプロダクト キーです。Office 2010 のライセンス処理の詳細については、「Office 2010 のボリューム ライセンス認証の概要」を参照してください。

例

<PIDKEY Value="1234512345123451234512345" />

構文

<RemoveLanguage Id="ll-cc**" />**

属性

備考

ユーザーのコンピューターに言語がインストールされていない場合、RemoveLanguage 要素は無視されます。

AddLanguage 要素 および RemoveLanguage の複数の要素を指定できます。RemoveLanguage 要素と AddLanguage 要素 要素の両方で同じ言語を指定している場合は、AddLanguage 要素 要素が優先され、その言語はインストールされます。

例

<RemoveLanguage Id="en-us" />

構文

<Setting Id="名前" Value="値" />

属性

備考

Windows インストーラーのすべてのプロパティが Setting 要素によって指定できるわけではありません。ブロックされるプロパティが指定されている場合、セットアップはインストール処理を終了します。サポートされるプロパティが指定されている場合、セットアップはそのプロパティを直接 Windows インストーラーに渡します。Windows インストーラーのすべてのプロパティの一覧と、サポートおよびブロックされるプロパティの説明については、「Office 2010 のセットアップ プロパティ」を参照してください。

Setting 要素では、次のキー管理システム (KMS) のプロパティがサポートされます。

• KMSSERVICENAME  KMS ホスト名を指定します。

• KMSSERVICEPORT  KMS ホスト ポートを指定します。

たとえば、KMS のプロパティを使用するには、次のような構文を使用します。

<Setting Id="KMSSERVICENAME" Value="contoso.com" />

<Setting Id="KMSSERVICEPORT" Value="1234" />

各部分の意味は次のとおりです。

contoso.com は KMS ホストの名前です。

1234 はポート番号の値です。

Setting 要素では、プロダクト キー ライセンス認証用の AUTO_ACTIVATE プロパティがサポートされています。このプロパティは、Office 2010 の展開時に製品のライセンス認証を自動的に実行することを指定します。以下の構文を使用します。

<Setting Id="AUTO_ACTIVATE" Value="1" />

Setting 要素では REMOVEPREVIOUS プロパティがサポートされています。このプロパティは、指定したアプリケーションをシステムから削除します。以下の構文を使用します。

<Setting Id="REMOVEPREVIOUS" Value="Option Id" />

ここで、オプション ID は Office 2010 アプリケーションの ID 値です。複数のアプリケーションを指定するには、カンマ区切りのリストを使用して、該当する オプション ID 値を指定します。

REMOVEPREVIOUS を オプション ID 値と一緒に指定した場合は、指定のアプリケーションのみが削除されます。

REMOVEPREVIOUS を指定しない場合は、以前にインストールされた Office アプリケーションのうち、代替となるアプリケーションがインストールされるものすべてが削除されます。これは既定の動作です。

REMOVEPREVIOUS に空の値を指定した場合 (REMOVEPREVIOUS="")、アプリケーションは削除されません。

Setting 要素では SETUP_REBOOT プロパティもサポートされています。SETUP_REBOOT により、インストール後に再起動が行われます。以下の構文を使用します。SETUP_REBOOT プロパティにはすべて大文字を使用する必要があります。

<Setting Id="SETUP_REBOOT" Value="value" />

ここで、"value" には以下のいずれかの値を指定できます。

• AutoAlways - 必ず再起動を行います。ユーザーに確認メッセージを表示しません。

• Always - セットアップ終了時の再起動についての確認メッセージを常に表示します。

• IfNeeded - セットアップで再起動が必要な場合は、セットアップ終了時の再起動についての確認メッセージを表示します (既定の動作)。

• AutoIfNeeded - セットアップで再起動が必要な場合は、再起動を開始します。ユーザーに確認メッセージを表示しません。

• Never - 再起動の開始もその確認メッセージの表示も行いません。

例

<Setting Id="SETUP_REBOOT" Value="Never" />
<Setting Id="REMOVEPREVIOUS" Value="WORDFiles" />

構文

<SetupUpdates

   [CheckForSUpdates="Yes"(既定値) | "No"]

   [SUpdateLocation="パスの一覧"]

/>

属性

備考

セットアップは、指定されたすべてのフォルダーで、インストール中の製品用に作成されたセットアップ カスタマイズ ファイルを検索し、見つかったファイルをファイル名のアルファベット順に適用します。セットアップのコマンド ラインでセットアップ カスタマイズ ファイルを指定した場合は、そのファイルが最初に適用され、この要素で指定されたフォルダー内で見つかったファイルはその後で適用されます。

例

<SetupUpdates
   CheckForSUpdates="Yes"
   SUpdateLocation="\\server1\office\updates;\\server2\corpdata\updates"
/>

構文

<USERINITIALS Value="値" />

属性

例

<USERINITIALS Value="JD" />

構文

<USERNAME Value="値" />

属性

備考

Office 2010 の Username 要素は、以下のように設定されます。

Office を実行するユーザーが、Office をインストールしたユーザーと同じである場合は、セットアップ時にユーザーが入力した Username と Initials が使用されます。ユーザーが、Office の初回起動時に入力を求められることはありません。Office を自分でインストールするホーム ユーザーであれば、ほとんどがこの場合に該当します。

Office を実行しているユーザーが Office をインストールしたユーザーと異なる場合には、Office の初回起動時にユーザーが Username と Initials の確認を求められます。管理者がユーザーに代わって Office をインストールする企業環境であれば、ほとんどがこの場合に該当します。

初回起動時にユーザーに表示される Username 要素の値には、以前にインストールされたバージョンの Office での既定値、または現在ログオン中のユーザーの既定値が、あらかじめ設定されていることがあります。ただし、この既定値の使用にはユーザーによる確認が必要です。以前のバージョンの Office がコンピューターにインストールされている場合は、以前のバージョンの Office によって作成されたレジストリ キーが使用されます。たとえば、以前にインストールされた Office が Microsoft Office 2003 であれば、そのレジストリ キーが HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo に設定されています。

例

<USERNAME Value="John Doe" />