.NET Framework の再配布
Microsoft Corporation
2002 年 1 月
概要：.NET Framework用に作成されたアプリケーションとコントロールでは、アプリケーションまたはコントロールが実行されるコンピューターに.NET Frameworkをインストールする必要があります。 .NET Framework再頒布可能パッケージは、スタンドアロンの実行可能ファイル (Dotnetfx.exe) として使用できます。 この記事では、Dotnetfx.exeを取得する場所と、それを使用してアプリケーション.NET Framework展開する方法について説明します。 (16ページ印刷)
メモお客様が作成したアプリケーションでの配布にDotnetfx.exeを使用する場合は、Microsoft .NET Framework SDK の有効なライセンスコピーを持っている必要があります。また、ライセンス製品に "ライセンス製品" として関連付けられているDotnetfx.exeの使用または配布が、Microsoft .NET Framework SDK のエンド ユーザー 使用許諾契約書 ("EULA") で定義されていることに同意するものとします。 Microsoft .NET Framework SDK の有効なライセンスを持っていない場合、またはこれらの使用条件に同意しない場合は、Dotnetfx.exe配布する権限がありません。
内容
はじめに
.NET Framework再頒布可能パッケージを取得する場所
Dotnetfx.exe展開シナリオ
Dotnetfx.exeのローカライズされたバージョンのインストール
最小構成要件
はじめに
Microsoft® .NET Framework のバージョン 1.0 リリースには、共通言語ランタイムと、.NET Framework アプリケーションの実行に必要な.NET Framework コンポーネントを含む再頒布可能パッケージ インストーラーが 1 つ用意されています。 .NET Framework再頒布可能パッケージは、スタンドアロンの実行可能ファイル (Dotnetfx.exe) として使用できます。 .NET Frameworkには、Dotnetfx.exeを再配布する特定の権限を付与する使用許諾契約書が必要です。 .NET Framework SDK、Microsoft Visual Studio® .NET を以前にインストールした場合、または Web からDotnetfx.exeをダウンロードした場合は、Dotnetfx.exeの使用許諾契約書に同意している必要があります。 使用許諾契約書の条項については、「再頒布可能パッケージ EULA .NET Framework」を参照してください。
Dotnetfx.exeを手動で起動してコンピューターにインストールすることも、.NET Framework アプリケーションのセットアップ プログラムの一部として起動してインストールすることもできます。 Dotnetfx.exeをインストールするには管理者特権が必要であることに注意してください。 .NET Framework SDK または Microsoft Visual Studio .NET を以前にインストールしている場合は、Dotnetfx.exeをインストールする必要はありません。
このホワイトペーパーに加えて、Dotnetfx.exeの展開に関する情報については、「.NET Framework展開ガイド」を参照してください。 この Web サイトでは、Visual Studio .NET ユーザーの特定の展開シナリオに対応するホワイトペーパーなど、詳細な展開情報を提供します。
Dotnetfx.exeをインストールするには、最小構成要件を満たす必要があります。 ソフトウェアとハードウェアの要件と推奨事項の詳細については、「最小構成要件」を参照してください。
.NET Framework再頒布可能パッケージを取得する場所
Dotnetfx.exeまたは Microsoft® Windows® Update Web サイトからダウンロードします。
または、製品 CD または DVD に再頒布可能パッケージを入手することもできます。 Dotnetfx.exeは、CD のルート ディレクトリにある dotNETRedist ディレクトリの .NET Framework SDK CD で使用できます。 これは、dotNetFramework ディレクトリの Microsoft® Visual Studio® .NET Windows コンポーネント更新 CD と、\wcu\dotNetFramework ディレクトリの Microsoft Visual Studio® .NET DVD で使用できます。
ユーザーにインターネットから.NET Frameworkをインストールさせる必要がある場合は、.NET Framework再頒布可能パッケージを投稿しないでください。代わりに、ユーザーを Microsoft Windows Update Web サイトに誘導します。
Dotnetfx.exe展開シナリオ
このセクションでは、.NET Framework SDK ユーザーに、Dotnetfx.exeを使用して.NET Frameworkを再配布するためのデプロイ シナリオについて説明します。 シナリオは、電子ソフトウェア配布ツールを使用してDotnetfx.exeを展開し、ネットワーク共有、イントラネット、または Microsoft Web サイト上のダウンロード場所から手動でインストールし、Setup.exe Bootstrapper サンプルを使用して、Dotnetfx.exeと.NET Framework アプリケーションの両方をインストールする単一のセットアップ プロジェクトを作成するためのシナリオです。 Dotnetfx.exeは重要なランタイム コンポーネントであるため、コンピューターにインストールするには管理者特権が必要です。 また、Dotnetfx.exeを使用して.NET Frameworkを再配布する場合は、サイレント インストールを実行することをお勧めします。
電子ソフトウェア配布ツールを使用したDotnetfx.exeの配布
.NET Frameworkアプリケーションを展開する企業では、.NET Frameworkを必要とする各アプリケーションに含めるのではなく、すべてのユーザーのコンピューターに 1 回展開する方が簡単です。 Dotnetfx.exeを展開したり、必要に応じて MDAC 2.6 以降をセキュリティで保護されたネットワークに展開したりするために、さまざまな電子配布ツールを使用できます。 Dotnetfx.exeの配布に使用するツールには、次の 2 つの要件があります。
- このツールは、リモート コンピューターでリモート インストールを実行できる必要があります
- このツールは、管理者特権で実行できる必要があります。
このセクションでは、Microsoft Systems Management Server (SMS) と Microsoft Active Directory® を使用して、.NET Framework再頒布可能パッケージをネットワーク経由で展開する方法について説明します。
Systems Management Server を使用した.NET Frameworkの展開
Systems Management Server (SMS) を使用すると、管理特権を持つソフトウェアをネットワーク全体に展開できます。 このセクションでは、SMS を使用してネットワーク経由でDotnetfx.exe用の Windows インストーラー セットアップ パッケージを展開する具体的な手順について説明します。 その他の SMS 製品情報とドキュメントについては、 Systems Management Server のホーム ページ と、 System Management Server 2.0 を使用した Windows インストーラー セットアップ パッケージの展開に関するページを参照してください。
.NET Framework再頒布可能パッケージDotnetfx.exeを管理者特権で展開するには、Dotnetfx.exe ファイルから Windows インストーラー ファイルnetfx.msi抽出する必要があります。 Netfx.msiは、.NET Frameworkのデプロイに使用するファイルです。 Netfx.msiを抽出したら、ネットワーク管理者コンピューターから SMS 管理者コンソールを実行し、ネットワーク上の選択したコンピューター グループにDotnetfx.exeを展開するように構成できます。
SMS クライアント コンピューターに Windows インストーラー セットアップ パッケージをインストールする前に、クライアント コンピューターに Windows インストーラー インストール サービスがインストールされている必要があります。 このセクションで説明する手順では、Windows インストーラー 2.0 が、Netfx.msiの展開前にすべてのクライアント コンピューターにインストールされていることを前提としています。 ネットワーク管理者は、すべてのクライアント コンピューターがこの要件を満たしていることを確認する責任があります。 SMS を使用して、クライアント コンピューターに Windows インストーラー 2.0 をインストールできます。 詳細については、「System Management Server 2.0 を使用した Windows インストーラー セットアップ パッケージの展開」を参照してください。
さらに、コンピューターに.NET Frameworkをインストールするために満たす必要がある最小構成要件があります。 特定のソフトウェアとハードウェアの要件と推奨事項については、「最小構成要件」を参照してください。
ネットワーク管理者が、Dotnetfx.exeがインストールされるすべてのネットワーク コンピューターが最小構成要件を満たしていることを確認したら、次の 5 つのタスクとその個々の手順を SMS サーバーで実行する必要があります。 これらの手順は、提示された順序で実行する必要があります。
まず、Dotnetfx.exe ファイルから Windows インストーラー ファイル (netfx.msi) を抽出します。 Netfx.msiは、.NET Frameworkのデプロイに使用するファイルです。
展開するDotnetfx.exe ファイルを抽出するには
- Dotnetfx.exeを C:\ のルート ディレクトリにダウンロードしますSMS サーバー上のドライブ。
- コマンド プロンプトを開きます。
- ディレクトリを C:\ のルートに変更します。ドライブ。
- コマンド プロンプトで「」と入力
mkdir dotnetfxして、Dotnetfx.exeをコピーするディレクトリを作成します。 - コマンド プロンプトで「」と入力
dotnetfx.exe /T:c:\dotnetfx /Cして、ファイルを dotnetfx ディレクトリに抽出します。
次に、.NET Frameworkの SMS パッケージを作成します。 SMS パッケージは、ソフトウェア配布の基本単位です。 これには、プログラムのソース ファイルと、ソフトウェア配布プロセスを指示する詳細が含まれています。
.NET Framework パッケージを作成するには
SMS 管理者コンソールを開きます。 [ スタート ] ボタンをクリックし、[ プログラム] をポイントして、[ システム管理サーバー] を選択します。
[サイト データベース] ノードを展開し、[サイト データベース] ツリーの [パッケージ] ノードを右クリックします。
[アクション] メニューの [新規] をポイントし、[パッケージ] を選択します。 [ パッケージのプロパティ ] ダイアログ ボックスが表示されます。
[ パッケージのプロパティ ] ダイアログ ボックスで、[ 全般 ] タブをクリックし、次のように情報を入力します。
名前: .NET Framework
バージョン: 1.0.3429.0
パブリッシャー： マイクロソフト
言語: 英語[ パッケージのプロパティ ] ダイアログ ボックスで、[ データ ソース ] タブをクリックします。
[このパッケージにはソース ファイルが含まれていますチェック] ボックスをクリックします。
[ 常にソース ディレクトリからファイルを取得 する] オプション ボタンをクリックします。
[ 設定... ] ボタンをクリックします。 [ ソース ディレクトリの設定 ] ダイアログ ボックスが表示されます。
[ ソース ディレクトリの設定 ] ダイアログ ボックスで、[ サイト サーバー上のローカル ドライブ ] オプション ボタンをクリックします。
[ 参照... ] ボタンをクリックします。 [ フォルダーの参照 ] ダイアログ ボックスが表示されます。
以前にファイルを抽出した C:\DotNetFx ディレクトリを選択します。
[ フォルダーの参照 ] ダイアログ ボックスで、[ OK ] ボタンをクリックします。
[ ソース ディレクトリの設定 ] ダイアログ ボックスで、[ OK ] ボタンをクリックします。
[ パッケージのプロパティ ] ダイアログ ボックスで、[ OK ] ボタンをクリックします。
次に、.NET Framework パッケージの.NET Framework プログラムを作成します。 各 SMS パッケージには、少なくとも 1 つの SMS プログラムが含まれています。これは、パッケージの実行を制御するために対象となる各コンピューターで実行されるコマンド ラインです。
.NET Framework パッケージのプログラムを作成するには
[パッケージ] ノードの下にある [Microsoft .NET Framework 1.0.3529.0 English] ノードを展開します。
[ プログラム] を右クリックし、[ 新規] をポイントして、[ プログラム] を選択します。 [ プログラムのプロパティ ] ダイアログ ボックスが表示されます。
[ プログラムのプロパティ ] ダイアログ ボックスで、[ 全般 ] タブをクリックし、次のように情報を入力します。
名前: .NET Framework プログラム
コマンド ライン: msiexec /i netfx.msi /q ARPSYSTEMCOMPONENT=1 ARPNOREMOVE=1[ プログラムのプロパティ ] ダイアログ ボックスで、[ 環境 ] タブをクリックします。
[ユーザー入力が必要なチェック] ボックスをオフにします。
オプション ボタン [管理者権限で 実行 ] をクリックします
[OK] をクリックします。
次に、.NET Framework パッケージの配布ポイントを作成します。 SMS 配布ポイントは、クライアント コンピューターがアクセスするためにパッケージ ソース ファイルをコピーするサイト システム上の共有です。
.NET Framework配布ポイントを作成するには
- Microsoft .NET Framework 1.0.3529.0 英語ノードの下にある配布ポイントを右クリックします
- [新規] を選択し、[配布ポイント] を選択します。 新しい配布ポイント ウィザードが表示されます。
- [ 新しい配布ポイント ウィザード ] ダイアログ ボックスで、[ 次へ ] ボタンをクリックします。
- .NET Framework パッケージをコピーする配布ポイントを選択します。
- [ 完了 ] ボタンをクリックして配布を開始します。
最後に、.NET Framework プログラムの提供情報を作成します。 提供情報は、クライアント コンピューターで使用できるプログラム、提供情報を受け取るコンピューター、およびプログラムのインストールスケジュールを設定するタイミングを指定します。
.NET Frameworkアドバタイズメントを作成するには
- [サイト データベース] ツリーで、[提供情報] ノードを右クリックします。
- [ 新規] を選択し、[ 提供情報] を選択します。 [ 提供情報のプロパティ ] ダイアログ ボックスが表示されます。
- [ 提供情報のプロパティ ] ダイアログ ボックスで、[ 全般 ] タブの情報を次のように入力します。
- [名前] セクションに「.NET Frameworkアドバタイズ」と入力します。
- [パッケージ] ドロップダウン リスト ボックスから [Microsoft .NET Framework 1.0.3529.0 English] を選択します。
- [プログラム] ドロップダウン リスト ボックスから [プログラムの.NET Framework] を選択します。
- [参照...] ボタンをクリックし、.NET Frameworkを展開するコンピューターの適切なコレクションを選択します。 .NET Frameworkを展開できるコンピューターを確認するには、「最小構成要件」を参照してください。
- [ OK] ボタンをクリックします
Active Directory を使用した.NET Frameworkの展開
Active Directory を使用すると、管理特権を持つソフトウェアをネットワーク全体に展開できます。 このセクションでは、Active Directory を使用してネットワーク経由でDotnetfx.exe用の Windows インストーラー セットアップ パッケージを展開するための具体的な手順について説明します。 Active Directory のその他の製品情報とドキュメントについては、 Active Directory のホーム ページを参照してください。
Active Directory クライアント コンピューターに Windows インストーラー セットアップ パッケージをインストールする前に、クライアント コンピューターに Windows インストーラー インストール サービスがインストールされている必要があります。 このセクションで説明する手順では、Windows インストーラー 2.0 が、Dotnetfx.exeの展開前にすべてのクライアント コンピューターにインストールされていることを前提としています。 Windows インストーラー 2.0 は、 Microsoft ダウンロード センターからダウンロードできます。 これらのインストーラー ファイルは、Active Directory を使用した展開用に設計されていないことに注意してください。 各コンピューターに個別にインストールするか、Systems Management Server を使用して電子的にインストールする必要があります。
さらに、コンピューターに.NET Frameworkをインストールするには、最小限の構成要件を満たす必要があります。 特定のソフトウェアとハードウェアの要件と推奨事項については、「最小構成要件」を参照してください。
ネットワーク管理者が、Dotnetfx.exeがインストールされるすべてのネットワーク コンピューターが最小構成要件を満たしていることを確認したら、次のタスクとその個々の手順を示された順序で実行します。
まず、.NET Frameworkのデプロイに使用するdotnetfx.exe ファイルを抽出します。
.NET Frameworkを展開するDotnetfx.exe ファイルを抽出するには
- Dotnetfx.exeを C:\ のルート ディレクトリにダウンロードします。ドライブをローカル コンピューターにインストールします。
- コマンド プロンプトを開きます。
- ディレクトリを C:\ のルートに変更します。ドライブ。
- コマンド プロンプトで「」と入力
mkdir dotnetfxして、Dotnetfx.exeコピーするディレクトリを作成します。 - コマンド プロンプトで「」と入力
dotnetfx.exe /T:c:\dotnetfx /Cして、ファイルを dotnetfx ディレクトリに抽出します。 - コマンド プロンプト ウィンドウを閉じます。
- Windows エクスプローラーの C:\dotnetfx フォルダーに移動し、ファイルが抽出されたことを確認します。
- dotnetfx フォルダーとそのすべての内容を、展開に使用するサーバーに移動します。
dotnetfx フォルダーを展開に適した場所に移動した後、次の手順では、.NET Frameworkの Active Directory パッケージを作成します。
Active Directory で.NET Framework パッケージを作成するには
- [ スタート ] ボタンをクリックし、[ プログラム] をポイントし、[ 管理ツール] をポイントします。 [ Active Directory ユーザーとコンピューター] をクリックします。 [Active Directory ユーザーとコンピューター] ツリーが表示されます。
- ツリーの上部にあるドメイン ノードを右クリックします。 ショートカット メニューの [ プロパティ ] をクリックします。 [プロパティ] ダイアログ ボックスが表示されます。
- [グループ ポリシー] タブをクリックします。
- [編集] ボタンをクリックします。 ウィンドウが既定のドメイン ポリシー ツリーと共に表示されます。
- ソフトウェアの割り当て方法を選択する場合は、2 つの選択肢があります。 グループ ポリシーの [コンピューター構成] ノードを選択すると、コンピューターにログオンするユーザーに関係なく、コンピューターに適用されるポリシーを設定できます。 または、グループ ポリシーの [ユーザー構成] ノードを選択して、ログオン コンピューターに関係なく、ユーザーに適用されるポリシーを設定することもできます。 この例では、[ ユーザー構成] ノードを選択して展開します。 [ユーザー構成] ノードの下にある [ソフトウェア設定] フォルダーを展開します。
- [ソフトウェアの インストール] を右クリックします。 [新規] をポイントし 、 ショートカット メニューの [ パッケージ ] をクリックします。
- パッケージの Windows インストーラー ファイル (.msi) へのパスの入力を求めるダイアログ ボックスが表示されます。 dotnetfx フォルダーをコピーした場所を参照し、 netfx.msi ファイルをクリックします。
- [ 公開済みの詳細設定] または [割り当て済み ] の選択を選択し、[ OK ] ボタンをクリックします。
- ソフトウェアの自動インストールまたは発行を選択できるウィンドウが表示されます。 [自動インストール] を選択すると、ドメイン内のすべてのコンピューターにソフトウェアが自動的にインストールされます。 [発行] を選択した場合、ソフトウェアは使用可能な製品の一覧に追加されますが、ユーザーがインストールを選択しない限りインストールされません。 必要なすべての項目を変更したら、[ OK ] ボタンをクリックします。
- Active Directory の [ユーザーとコンピューター] コンソールを終了します。
Active Directory で.NET Framework パッケージのセットアップを完了したら、次の手順として、パッケージがインストール可能であることを確認します。
Active Directory パッケージを確認するには
- ドメインの一部である任意のコンピューターにログオンします。 [スタート] ボタンをクリックし、[コントロール パネル] をポイントし、[プログラムの追加と削除] をクリックします。
- [ 新しいプログラムの追加] ボタンをクリックします。 .NET Frameworkインストール パッケージは、使用可能なソフトウェアの一覧に表示されます。
- .NET Frameworkインストール パッケージが使用可能なソフトウェアの一覧に表示されない場合、パッケージは Active Directory で正しく構成されていません。 Active Directory の [ユーザーとコンピューター] コンソールに戻り、パッケージをダブルクリックして再構成します。
ネットワーク管理者が Active Directory で.NET Framework パッケージを作成するときに [発行] オプションを選択すると、そのパッケージはドメイン内のコンピューターで使用できるソフトウェアの一覧に追加されます。 パッケージをインストールするユーザーは、クライアント コンピューターで次の手順に従うことができます。
.NET Framework パッケージをインストールするには
[スタート] ボタンをクリックし、[コントロール パネル] をポイントし、[プログラムの追加と削除] をクリックします。
[ 新しいプログラムの追加] ボタンをクリックします。
使用可能なソフトウェアの一覧で、.NET Framework パッケージを選択し、[追加] ボタンをクリックします。 これにより、Microsoft .NET Framework セットアップが起動します。
メモMicrosoft .NET Framework セットアップを起動する前に、クライアント コンピューターに Windows インストーラー 2.0 をインストールする必要があります。 Windows インストーラー 2.0 がインストールされていない場合、セットアップは失敗します。
インストーラーに [Microsoft .NET Framework セットアップ] ウィンドウが表示されたら、[次へ] ボタンをクリックします。
インストールを続行するには、[ 承諾 ] オプション ボタンをクリックし、[ 次へ ] ボタンをクリックします。 インストーラーによってファイルのコピーとシステムの更新が開始されます。
インストールが完了すると、インストーラーにダイアログ ボックスが表示されます。 [OK] をクリックします。
メモ.NET Framework パッケージを適切にアンインストールするには、Windows の [プログラムの追加と削除] オプションも使用する必要があります。
ネットワーク共有またはイントラネット サイトからDotnetfx.exeを手動でインストールする
ネットワーク共有または企業イントラネット サイト上のDotnetfx.exeのダウンロード場所にユーザーを誘導できます。 ユーザーは、.NET Framework アプリケーションを展開して実行するコンピューターにDotnetfx.exeを実行してインストールできます。 Dotnetfx.exeをインストールするには、コンピューターに対する管理者権限が必要です。
また、この.NET Frameworkでは、データ アクセスを含むアプリケーションに MDAC 2.6 以降をインストールする必要があります。 MDAC は、 ユニバーサル データ アクセス Web サイトからダウンロードできます。
Microsoft Web サイトからDotnetfx.exeを手動でインストールする
Dotnetfx.exeのダウンロード場所、または Microsoft Windows Update Web サイト上の場所にユーザーを誘導できます。 ユーザーは、.NET Framework アプリケーションを展開して実行するコンピューターにDotnetfx.exeを実行してインストールできます。 Dotnetfx.exeをインストールするには、コンピューターに対する管理者権限が必要です。
また、この.NET Frameworkでは、データ アクセスを含むアプリケーションに MDAC 2.6 以降をインストールする必要があります。 MDAC は、 ユニバーサル データ アクセス Web サイトからダウンロードできます。
.NET Framework アプリケーションとDotnetfx.exeをインストールするための単一セットアップ プロジェクトの作成
Setup.exe Bootstrapper サンプルの目的は、起動時に、必要に応じて再頒布可能パッケージ Dotnetfx.exe.NET Frameworkをインストールし、.NET Framework アプリケーションをインストールする単一のセットアップ プログラムを作成する方法を示することです。 このサンプルでは、Dotnetfx.exeと.NET Framework アプリケーションの Microsoft Windows インストーラー ベースのセットアップ プログラム (.msi ファイル) をブートストラップします。 このサンプルは、.NET Frameworkがインストールされていないコンピューターで実行できる必要があるため、アンマネージド コードで記述されています。 プリコンパイル済みバージョンの Setup.exeをダウンロードできます。
.NET Frameworkでは、データ アクセスを含むアプリケーションに MDAC 2.6 以降をインストールする必要があります。 Microsoft では、MDAC をインストールするために実行できるスタンドアロンの実行可能ファイルであるMDAC_typ.exeを提供しています。 ユニバーサル データ アクセス Web サイトからダウンロードできます。 データ アクセスを含む.NET Framework アプリケーションの場合は、FullInstallVer の値が 2.6 以降のレジストリ キー HKLM\SOFTWARE\Microsoft\DataAccess の存在を確認することで、Setup.exe Bootstrapper サンプルをサイレント インストールMDAC_typ.exeに拡張できます。 MDAC のインストールを Windows インストーラー パッケージ (.msi ファイル) でカプセル化するサンプル実行可能ファイルをダウンロードできます。「 Install DCOM and MDAC Through a Windows Installer Package」を参照してください。
Setup.exe Bootstrapper サンプルでは、次のアクションを実行します。
- 指定したバージョンの.NET Frameworkがターゲット コンピューターにインストールされているかどうかを確認します。
- 指定したバージョンがインストールされていない場合は、Dotnetfx.exeのサイレント インストールが起動され、必要に応じて Windows インストーラー 2.0 にアップグレードされます。 コンピューターの再起動が必要な場合があります。
- ホスト .NET Framework アプリケーションをインストールします。 コンピューターの再起動が必要な場合は、ホスト アプリケーションのインストールが完了するまで抑制されます。
.NET Frameworkがインストールされているかどうかを検出する
Setup.exe Bootstrapper サンプルでは、セットアップ プログラムをラップして、.NET Frameworkがインストールされているかどうかを確認するために使用するコードを示します。 コードは、次のレジストリ キー内の.NET Frameworkの指定されたバージョン番号を確認します。
HKLM\SOFTWARE\Microsoft\.NETFramework\policy\v1.0
チェックするバージョン番号は、Dotnetfx.exeから取得されます。 このコードでは、レジストリ キー内のビルド番号と、アプリケーションによってホストされている.NET Frameworkのビルド番号との比較が実行されます。 この場所のレジストリ キーに一致するビルド番号がない場合は、アプリケーションによってホストされている.NET FrameworkのバージョンSetup.exeインストールされます。
.NET Frameworkのビルド番号と言語バージョンをチェックSetup.exeする場合は、settings.iniファイルでチェックする言語のカルチャ名を指定する必要があることに注意してください。 カルチャ名を指定しない場合、Setup.exeは既定で英語版を確認します。 カルチャ名の指定手順については、「 Settings.ini ファイルの作成 」トピックを参照してください。
Dotnetfx.exeのサイレント インストールの起動
次のコマンドは、Dotnetfx.exeのサイレント インストールを起動します。
dotnetfx.exe /q:a /c:"install /l /q"
サイレント インストールでは、Dotnetfx.exeとInstall.exeによって返されるすべてのユーザー インターフェイスとエラー メッセージ (Dotnetfx.exe内に含まれる) の表示が抑制されます。 サイレント インストールの /q:a オプションと /q オプションを指定すると、標準化されたユーザー インストール エクスペリエンスが可能になります。 オプションを /l 指定すると、すべてのエラーが記録される %temp% ディレクトリにセットアップ ログ ファイル netfx.log が作成されます。
一般的なエラー コードの処理
次の表では、Setup.exe Bootstrapper サンプルによって処理される一般的なエラーについて説明します。
| エラー | 既定のテキスト |
|---|---|
| 3010 | セットアップには再起動が必要です。 今すぐ再起動しますか?
再起動が必要です。 |
| 8192 | セットアップには再起動が必要です。 今すぐ再起動しますか?
Windows インストーラーのインストール後にコンピューターを再起動する必要があります。 |
| 4101 | セットアップの別のインスタンスが既に実行されています。
セットアップの別のインスタンスが実行されている場合は、続行が許可され、現在のインストールを続行できません。 |
| 4097 | このアプリケーションをインストールするために必要なアクセス許可がありません。 管理者に問い合わせてください。
Windows NT では、(インストールを解除する) 管理者特権が必要です。 |
| 1633 | このアプリケーションを実行するようにコンピューターが正しく構成されていません。 サポートにお問い合わせください。
プラットフォームが無効です。 |
| その他のすべてのエラー | セットアップでエラーが発生しました。 インストールを続行できません。
セットアップ中に致命的なエラーが発生しました。 Dotnetfx.exeのインストールを続行できません。 |
アプリケーションの MSI セットアップを呼び出し、アプリケーションがインストールされるまで再起動を抑制する
次のコマンドは、ホスト アプリケーション myapp.msiの MSI セットアップを呼び出します。 オプションを REBOOT=ReallySuppress 選択すると、インストールが完了するまで myapp コンピューターの再起動が抑制されます。
msiexec /i myapp.msi REBOOT=ReallySuppress
Setup.exe Bootstrapper サンプルでは、ホスト アプリケーションによって生成されるエラー コードをチェックする必要はありません。これはサイレント インストールではなく、myapp, Windows インストーラー のユーザー インターフェイスを介してすべてのエラーがユーザーに表示されるためです。
Settings.ini ファイルの作成
Setup.exe Bootstrapper サンプルでは、外部ファイルsettings.iniを使用して 、 次の決定を行います。
- Dotnetfx.exeとホスト アプリケーションの場所。
- チェック対象の.NET Frameworkの言語バージョン。
- Setup.exeダイアログ ボックスに使用するカスタム文字列。
settings.iniの既定の場所は、Setup.exeと同じフォルダーにあります。 Setup.exe Bootstrapper サンプルに付属の settings.ini ファイルをコピーし、必要に応じてファイルを編集して、アプリケーションの正しい値を指定できます。
Dotnetfx.exeとホスト アプリケーションの場所を指定する
Setup.exe ブートストラップ サンプルでは、Dotnetfx.exeとホスト .NET Framework アプリケーションが、Setup.exeに関連する既知の場所に存在する必要があります。 Setup.exe ブートストラップ サンプルでは、外部ファイルsettings.ini を使用して 、 Dotnetfx.exeとホスト アプリケーションの場所を決定します。 サンプルに付属のsettings.ini ファイルをコピーし、.NET Framework ホスト アプリケーションとDotnetfx.exeの場所をポイントするようにファイルを編集できます。
次のsettings.iniファイルの例は、ホスト .NET Framework アプリケーションの Windows インストーラー パッケージ (.msi ファイル) をポイントし、Setup.exeの場所を基準にしてさまざまな場所にDotnetfx.exeする方法を示しています。
次の例settings.iniファイルは、.NET Framework アプリケーションの Windows インストーラー パッケージを指し、mySetup.msi,Setup.exeとDotnetfx.exe同じフォルダーにあります。
[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application
DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\
次の例settings.iniファイルは、Setup.exeとは別に、mySetup.msiDotnetfx.exeネットワーク共有上にある.NET Framework アプリケーションの Windows インストーラー パッケージを指しています。
[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\
次の例settings.iniファイルは、.NET Framework アプリケーションの Windows インストーラー パッケージを指し、mySetup.msiSetup.exeとDotnetfx.exe同じコンピューター上にあり、フォルダーは異なります。
[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\
次の例settings.iniファイルは、.NET Framework アプリケーションの Windows インストーラー パッケージ を指し、mySetup.msiSetup.exeとDotnetfx.exe同じ CD 上にあり、フォルダーは異なります。
[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/
言語バージョンを指定する
ビルド番号と.NET Frameworkの言語バージョンをチェックSetup.exeする場合は、settings.iniファイルでチェックする言語のカルチャ名を指定する必要があります。 カルチャ名を指定しない場合、Setup.exeは既定で英語版を確認します。
次の表に、使用可能な言語バージョンと、 settings.ini ファイルで指定するカルチャ名を示します。
| Language | カルチャ名 |
|---|---|
| 簡体中国語 | CHS |
| 繁体中国語 | CHT |
| フランス語 | fr |
| ドイツ語 | de |
| イタリア語 | it |
| 日本語 | ja |
| 韓国語 | ko |
| スペイン語 | es |
次のsettings.ini ファイルの例では、フランス語バージョンのDotnetfx.exeをチェックするようにSetup.exeに指示します。
[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\
Setup.exe ダイアログ ボックスの文字列をカスタマイズする
settings.ini ファイル内の次の変数を編集して、Setup.exeダイアログ ボックスに表示される文字列をカスタマイズできます。
ProductName
インストールする.NET Framework アプリケーションSetup.exeの名前を指定します。 指定した製品名は、Setup.exeを起動した後に表示されるダイアログ ボックスのテキストをカスタマイズするために使用されます。 たとえば、[マイ アプリケーション] を ProductName として指定した場合、ダイアログ ボックスのテキストに "アプリケーションのセットアップを開始するには、[OK] をクリックします。 インストールせずに終了するには、[キャンセル] をクリックします。CaptionText 変数をカスタマイズしない場合、ProductName は、Setup.exeの起動後に表示されるダイアログ ボックスのタイトル バーをカスタマイズするためにも使用されます。 たとえば、ProductName として [マイ アプリケーション] を指定すると、タイトル バーに "My Application Setup" と表示されます。ProductName と CaptionText の両方をカスタマイズする場合は、CaptionText を使用してこのダイアログ ボックスのタイトル バー テキストをカスタマイズします。
ProductName は、アプリケーションのインストールが完了したときに表示される成功ダイアログ ボックスのタイトル バー テキストをカスタマイズするためにも使用されます。 ProductName をカスタマイズしない場合は、既定のテキスト "アプリケーションセットアップ" が表示されます。
DialogText
Setup.exeを起動した後に表示されるダイアログ ボックスに表示するカスタム テキストを指定します。 DialogText をカスタマイズしない場合は、既定のテキスト "アプリケーションセットアップを開始するには、[OK] をクリックします。 インストールせずに終了するには、[キャンセル] をクリックします。CaptionText
Setup.exeを起動した後に表示されるダイアログ ボックスのタイトル バーに表示するカスタム テキストを指定します。 CaptionText をカスタマイズしない場合は、ProductName が表示されます。 ProductName がカスタマイズされていない場合は、既定のテキスト "Application Setup" が表示されます。ErrorCaptionText
エラー ダイアログ ボックスのタイトル バーに表示するカスタム テキストSetup.exe指定します。 ErrorCaptionText をカスタマイズしない場合は、既定のテキスト "アプリケーション セットアップ エラー" が表示されます。
セットアップ プログラム用の readme ファイルの作成
セットアップ プログラムを正常に実行できるコンピューターの最小構成要件を一覧表示する readme ファイルを使用してセットアップ プログラムを配布することをお勧めします。 インストールする前に、少なくとも、インターネット エクスプローラー 5.01 以降が要件としてインストールされている Microsoft Windows 98 以降を一覧表示します。 MDAC 2.6 以降も一覧表示する必要があります。インストールには不要ですが、データ アクセスを含む.NET Frameworkアプリケーションには必要です。 Dotnetfx.exeをインストールするための最小構成要件の詳細については、「最小構成要件」を参照してください。
ローカライズされたバージョンのDotnetfx.exeのインストール
Dotnetfx.exeは 8 つの言語にローカライズされています。 使用可能な言語の完全な一覧については、前のセクションの表を参照してください。 ローカライズされたバージョンのDotnetfx.exeまたは Microsoft Windows Update Web サイトをダウンロードできます。
.NET Framework再頒布可能パッケージ (Dotnetfx.exe) を Microsoft Windows® 98 オペレーティング システムを実行しているコンピューターにインストールする場合は、コンピューター上で実行されているローカライズバージョンの Windows 98 に対応するローカライズされたバージョンのDotnetfx.exeをインストールする必要があります。 たとえば、ドイツ語バージョンの Windows 98 を実行しているコンピューターに、ドイツ語バージョンのDotnetfx.exeをインストールする必要があります。 この制限は、Windows 98 にのみ適用されます。 Windows ME、Windows 2000、Windows NT® 4.0、Windows XP、または Windows Server 2003 ファミリの任意の言語バージョンのDotnetfx.exeをインストールできます。
最小構成要件
このセクションでは、.NET Framework再頒布可能パッケージをインストールするコンピューターの最小構成要件について説明します。 最小要件が満たされていない場合、Dotnetfx.exeセットアップによって再頒布可能パッケージのインストールがブロックされます。 具体的には、Microsoft Windows 95 オペレーティング システムを実行しているコンピューターに.NET Framework再頒布可能パッケージをインストールできないことに注意してください。
プラットフォームとソフトウェアの要件
最小要件
Dotnetfx.exeをインストールするには、コンピューターに Microsoft Internet エクスプローラー 5.01 以降がインストールされている次のいずれかのオペレーティング システムが必要です。
- Microsoft Windows 98
- Microsoft Windows 98 Second Edition
- Microsoft Windows Millennium Edition (Windows Me)
- Microsoft Windows NT 4 (ワークステーションまたはサーバー) Service Pack 6a
- Microsoft Windows 2000 (Professional、Server、または Advanced Server) と、 Microsoft セキュリティ Web サイトから入手できる最新の Windows Service Pack と重要な更新プログラム。
- Microsoft Windows XP (ホームまたはプロフェッショナル)
- Microsoft Windows Server 2003 ファミリ
注意Windows .NET Server Beta 3 にDotnefx.exeをインストールすると、オペレーティング システムにインストールされている.NET Frameworkのバージョンが中断されます。 Windows .NET Server Beta 3 では、.NET Frameworkのバージョン 1.0.3215 がインストールされます。 新しいバージョンの.NET Frameworkをインストールすると、バージョン 1.0.3215 が壊れます。 新しいバージョンをインストールする場合は、新しいバージョンを実行して使用できます。 ただし、以降のバージョンをアンインストールした後でも、バージョン 1.0.3215 を使用することはできません。
推奨されるソフトウェア
アプリケーションの要件によっては、次の 1 つ以上をインストールする必要がある場合もあります。
- データ アクセス用の MDAC 2.6 以降。 ユニバーサル データ アクセス Web サイトから入手できます。
- Windows インストルメンテーション用のコア WMI。
メモ 推奨されるソフトウェア要件が満たされていない場合、セットアップによってインストールがブロックされたり、存在しないという警告が表示されたりしません。
推奨されるサーバー ソフトウェア
アプリケーションの要件によっては、次のサーバー ソフトウェアが必要になる場合もあります。
- サーバー上のデータ用 MDAC 2.7。 ユニバーサル データ アクセス Web サイトで入手できます。
- Windows 2000、Windows XP (Professional)、Windows Server 2003 用のサーバー上のインターネット インフォメーション サービス (IIS)。 これは、ASP.NET アプリケーションを使用するために必要です。
ハードウェア要件
ハードウェアに最低限必要な条件
| シナリオ | 必要な CPU | RAM が必要です |
| Client | Pentium 90 MHz* | 32 MB** |
| サーバー | Pentium 133 MHz* | 128 MB** |
* または、オペレーティング システムを実行するために必要な最小 CPU のいずれか高い方。
** または、オペレーティング システムを実行するために必要な最小 RAM のいずれか高い方。
推奨されるハードウェア要件
| シナリオ | CPU 推奨 | 推奨される RAM |
|---|---|---|
| Client | Pentium 90 MHz 以上 | 96 MB 以上 |
| サーバー | Pentium 133 MHz 以上 | 256 MB 以上 |