2007 Office system の Config.xml ファイル

構文

<Configuration [Product="productID"] >

   ...

</Configuration>

属性

備考

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

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

例

Office Enterprise 2007 の productID は、Enterprise.WW\Setup.xml の以下の行にあります。

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

この productID を Config.xml で使用して Office Enterprise 2007 を指定するには、次のように入力します。

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

構文

<AddLanguage

   Id="ll-cc" | "match"

   [ShellTransform="Yes"]

/>

属性

備考

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

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

2007 Office system をインストールする際は、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 属性を指定します。これにより、セットアップがシェルの 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 属性 =" 値 " [属性**="値"**] ... />

属性

構文

<CCP_DRIVE Value=" 値 " />

属性

例

<CCP_DRIVE Value="\\server\office2003" />

構文

<Command

   Path="path"

   [QuietArg="arguments"]

   [Args="args"]

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

   [Wait="mseconds"]

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

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

/>

属性

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

備考

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

コマンド ラインでは、該当する製品のインストール時に任意のコマンドを実行するか、または目的の軽量の実行可能ファイルを実行するように指定できます。

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

重要
チェーン処理は、各製品を個別にインストールする場合ほど信頼性が高くありません。たとえば、2 つのインストールをチェーン処理し、1 つの製品でインストールが失敗したり、予期しないエラーが発生した場合、主要なインストールおよびチェーン処理されたインストールが正常に完了していない可能性があります。そのため、チェーン処理の使用はお勧めしません。企業環境で複数の製品を同時にインストールする場合は、チェーン処理ではなく、Microsoft System Center Configuration Manager 2007、Microsoft Systems Management Server (SMS) 2003、サードパーティ製ツールなどの展開管理プログラムを使用することをお勧めします。

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

• Args 属性は必ずコマンドに追加します。これには、"/install"、**"Company=**MyCorporation" などのスイッチを含めることができます。

• セットアップをサイレント実行する場合 (Display を Display="none" として設定) は、QuietArg 属性も追加します。このような場合は、QuietArg 属性に "/quiet" スイッチを指定できます。たとえば、QuietArg="/quiet" と指定できます。

Wait 属性の特長を以下に示します。

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

  リターン コードが関係するのは、Wait 値がゼロでない場合のみです。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 " />

属性

例

<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" AcceptEula="Yes" />

構文

<DistributionPoint Location=" path " />

属性

備考

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

例

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

構文

<INSTALLLOCATION Value=" path " />

属性

備考

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

例

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

構文

<LIS

[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]

[SOURCELIST=" semicolon-delimited-path-list "]

/>

属性

備考

既定では、LIS は、Office のインストール先のドライブのルートにある \MsoCache\All Users フォルダに作成されます。ネットワーク インストール ポイントの 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="path"

   Template="filename.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="version"

   WindowsBuild="number"

   ServicePackLevel="number"

/>

属性

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

備考

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

システム要件の詳細については、「2007 Office system の概要」を参照してください。

構文

<OptionState

   Id="optionID"

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

   [Children="force"]

/>

属性

備考

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

OptionState の Id 値の一覧については、「Config.xml ファイルの OptionState Id 値」を参照してください。Config.xml で OptionState 要素を変更する方法については、「グループ ポリシーのソフトウェアのインストールを使用して 2007 Office system を展開する」の「Config.xml ファイルの OptionState 要素を変更する」を参照してください。

例

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

構文

<PIDKEY Value=" 25-character-key " />

属性

備考

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

例

<PIDKEY Value="1234512345123451234512345" />

構文

<RemoveLanguage Id=" ll - cc " />

属性

備考

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

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

例

<RemoveLanguage Id="en-us" />

構文

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

属性

備考

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

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

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

ここで、Option Id は 2007 Office system アプリケーションの ID 値です。複数のアプリケーションを指定するには、カンマ区切りのリストを使用して、該当する Option Id 値を指定します。Option Id 値の一覧については、「Config.xml ファイルの OptionState Id 値」を参照してください。

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

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

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

Setting 要素では 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="path-list"]

/>

属性

備考

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

例

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

構文

<USERINITIALS Value=" value " />

属性

例

<USERINITIALS Value="JD" />

構文

<USERNAME Value=" value " />

属性

備考

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

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

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

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

例

<USERNAME Value="John Doe" />