マニフェストの生成および編集ツール (Mage.exe)
更新 : 2007 年 11 月
マニフェストの生成および編集ツール (Mage.exe) は、アプリケーション マニフェストおよび配置マニフェストの作成と編集をサポートするコマンド ライン ツールです。コマンド ライン ツールであるため、Mage.exe は、バッチ スクリプトから実行することも、ASP.NET アプリケーションなど他の Windows ベースのアプリケーションから実行することもできます。
Mage.exe の代わりに、グラフィカルなアプリケーション プログラムである MageUI.exe を使用することもできます。詳細については、「マニフェスト生成および編集ツールのグラフィカル クライアント (MageUI.exe)」を参照してください。
Mage.exe と MageUI.exe は、次に示すような、さまざまな場所から入手できます。
.NET Framework 2.0 SDK。.NET Framework 2.0 SDK は、Visual Studio 2005 セットアップのコンポーネントとして利用できます。Microsoft .NET Framework の Web サイトからダウンロードできます。
Windows SDK for Windows Vista。Windows SDK for Windows Vista は、Microsoft ダウンロード センターからダウンロードできます。
Visual Studio 2008。新しいバージョンの Mage.exe および MageUI.exe は、Visual Studio 2008 セットアップのコンポーネントとして含まれています。
Mage [commands] [commandOptions]
パラメータ
次の表に、Mage.exe でサポートされているコマンドを示します。これらのコマンドでサポートされるオプションの詳細については、「New コマンド オプションと Update コマンド オプション」および「Sign コマンド オプション」を参照してください。
コマンド |
説明 |
|---|---|
-cc, ClearApplicationCache |
すべてのオンライン専用アプリケーションのダウンロード アプリケーション キャッシュをクリアします。 |
-n, -NewfileType [newOptions] |
指定された種類のファイルを新規作成します。有効な種類は、次のとおりです。
このコマンドで他のパラメータを指定しなかった場合は、適切な既定のタグおよび属性値を使用して、適切な種類のファイルが作成されます。 –ToFile オプション (次の表を参照) を使用して、新しいファイルの名前とパスを指定します。 マニフェストの <dependency> セクションに追加されたアプリケーション用のすべてのアセンブリを使用して、アプリケーション マニフェストを作成する場合は、–FromDirectory オプション (次の表を参照) を使用します。 |
-u, -Update[filePath] [updateOptions] |
1 つ以上の変更をマニフェスト ファイルに加えます。編集中のファイルの種類を指定する必要はありません。Mage.exe は、一連のヒューリスティックを使用してファイルを調査し、配置マニフェストであるのか、アプリケーション マニフェストであるのかを判定します。 ファイルが証明書で署名済みの場合に -Update を指定すると、キー署名ブロックが削除されます。これは、キー署名にはファイルのハッシュが含まれているため、ファイルを変更するとハッシュが無効になるためです。 –ToFile オプション (次の表を参照) を使用して、既存のテキストに上書きするのではなく、新しいファイルの名前とパスを指定します。 |
-s, -Sign[signOptions] |
証明書を使用してファイルに署名します。署名は、XML 要素としてファイルに挿入されます。 |
-h, -?, -Help[verbose] |
使用可能なすべてのコマンドおよびそのオプションの説明が表示されます。verbose を指定して、詳細なヘルプを表示します。 |
New コマンド オプションと Update コマンド オプション
次の表は、–New コマンドおよび –Update コマンドでサポートされているオプションを示しています。
オプション |
既定値 |
対象 |
説明 |
|---|---|---|---|
-appc, -AppCodeBasemanifestReference |
配置マニフェスト |
アプリケーション マニフェスト ファイルへの URL またはファイル パス参照を挿入します。このファイルは、アプリケーション マニフェストへの完全パスである必要があります。 |
|
-appm, -AppManifestmanifestPath |
配置マニフェスト |
配置のアプリケーション マニフェストへの参照を、その配置マニフェストに挿入します。 manifestPath に指定したファイルは存在する必要があります。存在しない場合、Mage.exe はエラーを発行します。manifestPath の参照先のファイルがアプリケーション マニフェストでない場合、Mage.exe はエラーを発行します。 |
|
-cf, -CertFilefilePath |
すべてのファイルの種類 |
マニフェストに署名するための証明書の場所を指定します。証明書にパスワードが必要な場合は、このオプションを –Password オプションと共に使用できます。 |
|
-ch, -CertHashhashSignature |
すべてのファイルの種類 |
クライアント コンピュータの個人証明書ストアに格納されているデジタル証明書のハッシュです。これは、Windows の証明書コンソールに表示されるデジタル証明書のサムプリント文字列に対応しています。 hashSignature には、大文字も小文字も使用できます。また、1 つの文字列で指定することも、サムプリント文字の各オクテット (8 ビット) を空白で区切り、サムプリント全体を引用符で囲んで指定することもできます。 |
|
-fd, -FromDirectorydirectoryPath |
アプリケーション マニフェスト |
directoryPath で見つかったすべてのアセンブリとファイルの説明を含めたアプリケーション マニフェストを作成します。directoryPath は、配置対象のアプリケーションが格納されているディレクトリです。Mage.exe では、ディレクトリ内のファイルごとに、そのファイルがアセンブリなのかスタティック ファイルなのかが判断されます。アセンブリの場合は、<dependency> タグおよび installFrom 属性が、アセンブリ名、コード ベースおよびバージョンと共に、アプリケーションに追加されます。スタティック ファイルの場合は、<file> タグが追加されます。また、Mage.exe は、簡単な一連のヒューリスティックによってアプリケーションのメイン実行可能モジュールを検出し、この実行可能モジュールを ClickOnce アプリケーションのエントリ ポイントとしてマニフェストでマークします。 Mage.exe では、ファイルが "データ" ファイルとして自動的にマークされることはありません。これは手動で行う必要があります。詳細については、「方法 : ClickOnce アプリケーションにデータ ファイルを含める」を参照してください。 Mage.exe では、各ファイルのサイズに基づいて、各ファイルのハッシュも生成されます。ClickOnce では、マニフェスト作成後に、配置の各ファイルが改ざんされていないことを確認するためにこれらのハッシュを使用します。配置対象のファイルに変更を加えた場合には、Mage.exe を –Update コマンドおよび –FromDirectory オプションを付けて実行すると、参照している全ファイルのハッシュおよびアセンブリ バージョンを更新できます。 -FromDirectory を指定すると、directoryPath で見つかった全サブディレクトリの全ファイルが含まれます。 –FromDirectory を –Update コマンドと共に使用すると、アプリケーション マニフェスト内のファイルのうち、このディレクトリに存在しなくなったファイルが Mage.exe によってマニフェストから削除されます。 |
|
-i, -InstallwillInstall |
true |
配置マニフェスト |
ClickOnce アプリケーションをローカル コンピュータにインストールするのか、Web サイトで実行するのかを指定します。アプリケーションをインストールすると、アプリケーションは Windows の [スタート] メニューに表示されます。有効な値は、"true" または "t"、および "false" または "f" です。 –MinVersion オプションを指定し、ユーザーが -MinVersion より前のバージョンをインストールしていた場合は、-Install に渡した値に関係なく、アプリケーションがインストールされます。 このオプションは、-BrowserHosted オプションと一緒に使用することはできません。1 つのマニフェストに両方のオプションを使用しようとすると、エラーが発生します。 |
-mv, -MinVersion [version] |
-Version フラグで指定された、ClickOnce 配置マニフェストに示されたバージョン |
配置マニフェスト |
ユーザーが実行できる、このアプリケーションの最小バージョンです。このフラグで指定したバージョンが、アプリケーションの最低限必要なバージョンになります。大幅に変更された更新を含むバージョンや、重大なセキュリティ問題を解決したバージョンの製品をリリースした場合に、このフラグを使用すると、この更新バージョンを必ずインストールするように指定でき、ユーザーは古いバージョンを実行できなくなります。 version は、-Version フラグの引数と同じ意味を持ちます。 |
-n, -NamenameString |
deploy |
すべてのファイルの種類 |
アプリケーションを識別するための名前です。ClickOnce では、[スタート] メニュー (アプリケーションをインストールする場合) や [Permission Elevation] ダイアログ ボックスでこのアプリケーションを示す名前として、この名前が使用されます。 |
-pwd, -Passwordpasswd |
すべてのファイルの種類 |
デジタル証明書でマニフェストに署名する場合に使用するパスワードです。–CertFile オプションと共に使用する必要があります。 |
|
-p, ProcessorprocessorValue |
msil |
アプリケーション マニフェスト 配置マニフェスト |
このアプリケーションを実行するマイクロプロセッサのアーキテクチャです。特定のマイクロプロセッサ用にアセンブリがプリコンパイルされている、1 つ以上のアプリケーションを配置する場合は、この値を指定する必要があります。有効な値は、msil、x86、ia64、amd64 です。msil は Microsoft Intermediate Language のことで、アセンブリがどのプラットフォームにも依存していないことを示します。この場合、共通言語ランタイム (CLR : Common Language Runtime) では、アプリケーションの最初の実行時に各アセンブリの Just-In-Time コンパイルを行います。 |
-pu,-ProviderUrlurl |
配置マニフェスト |
ClickOnce でアプリケーションの更新チェックを行う場合に参照する URL を指定します。 |
|
-pub, -PublisherpublisherName |
アプリケーション マニフェスト 配置マニフェスト (.NET Framework 3.5 で新たに追加されました) |
配置マニフェストとアプリケーション マニフェストのいずれかの description 要素に発行者名を追加します。アプリケーション マニフェストで使用する場合、-UseManifestForTrust も指定する必要があります (値は "true" または "t" に設定します)。指定しないと、エラーが発生します。 |
|
-ti, -TimestampUriuri |
アプリケーション マニフェスト 配置マニフェスト |
デジタル タイムスタンプ サービスの URL です。マニフェストにタイムスタンプを設定すると、マニフェストに再署名することを防止できますが、アプリケーションの次のバージョンを配置する前にデジタル証明書の有効期限が切れるようにする必要があります。現在のところ、タイムスタンプ サービスをサポートしているのは VeriSign だけです。引数として指定する URI は、"http://timestamp.verisign.com/scripts/timstamp.dll" です。 |
|
-tr, -TrustLevellevel |
Intranet |
アプリケーション マニフェスト |
クライアント コンピュータ上のアプリケーションに与える信頼のレベルです。有効な値には、"Internet"、"Intranet"、および "FullTrust" が含まれます。 |
-t, -ToFilefilePath |
|
すべてのファイルの種類 |
作成または変更されたファイルの出力パスを指定します。 –New を使用するときに –ToFile を指定しなかった場合、出力ファイルは現在の作業ディレクトリに書き込まれます。–Update を使用する場合に –ToFile を指定しなかった場合、Mage.exe では、入力ファイルにファイルが書き戻されます。 |
-u, -UseManifestForTrustwillUseForTrust |
false |
アプリケーション マニフェスト (.NET Framework 3.5 で新たに追加されました) |
アプリケーションをクライアントで実行するときに、アプリケーション マニフェストのデジタル署名を信頼の決定に使用するかどうかを指定します。"true" または "t" を指定すると、信頼の決定にアプリケーション マニフェストが使用されます。"false" または "f" を指定すると、信頼の決定に配置マニフェストの署名が使用されます。 |
-v, -VersionversionNumber |
1.0.0.0 |
アプリケーション マニフェスト 配置マニフェスト |
配置のバージョンです。引数は "N.N.N.N" という形式の有効なバージョン文字列である必要があります。ここで "N" は、32 ビット符号なし整数です。 |
-wpf, -WPFBrowserApp isWPFApp |
false |
アプリケーション マニフェスト 配置マニフェスト (.NET Framework 3.5 で新たに追加されました) |
このフラグは、アプリケーションが Internet Explorer の内部でホストされ、スタンドアロンの実行可能ファイルではない Windows Presentation Foundation (WPF) アプリケーションである場合にのみ使用します。有効な値は、"true" または "t"、および "false" または "f" です。 アプリケーション マニフェストの場合、そのアプリケーション マニフェストの entryPoint 要素に hostInBrowser 属性を追加します。 配置マニフェストの場合、deployment 要素の install 属性に false を設定し、.xbap 拡張子を指定して配置マニフェストを保存します。この引数を -Install 引数と共に指定すると、ブラウザによってホストされるアプリケーションをインストールできず、アプリケーションがオフラインになるため、エラーが発生します。 |
Sign コマンド オプション
次の表は、–Sign コマンドでサポートされているオプションを示しています。このコマンドは、すべての種類のファイルに適用されます。
オプション |
説明 |
|---|---|
-cf, -CertFilefilePath |
マニフェストに署名するための証明書の場所を指定します。このオプションは –Password オプションと共に使用できます。 |
-ch, -CertHashhashSignature |
クライアント コンピュータの個人証明書ストアに格納されているデジタル証明書のハッシュです。これは、Windows の証明書コンソールに表示されるデジタル証明書の拇印プロパティに対応しています。 hashSignature には、大文字も小文字も使用できます。また、1 つの文字列で指定することも、サムプリント文字の各オクテット (8 ビット) を空白で区切り、サムプリント全体を引用符で囲んで指定することもできます。 |
-p, -Passwordpasswd |
デジタル証明書でマニフェストに署名する場合に使用するパスワードです。–CertFile オプションと共に使用する必要があります。 |
-t, -ToFilefilePath |
作成または変更されたファイルの出力パスを指定します。 |
解説
Mage.exe では、どの引数も大文字と小文字が区別されません。コマンドおよびオプションの前には、ダッシュ (-) またはスラッシュ (/) を付けることができます。
–Sign コマンドと共に使用できる引数は、すべて、–New コマンドまたは –Update コマンドでも、常に使用できます。次のコマンドは同等です。
mage –Sign c:\HelloWorldDeployment\HelloWorld.deploy –CertFile cert.pfx
mage –Update c:\HelloWorldDeployment\HelloWorld.deploy –CertFile cert.pfx
署名済みのファイルでは、文書のシグネチャが有効であるかどうかがファイルのハッシュによって確認されるため、署名は最後に行う必要があります。署名済みのファイルに変更を加えた場合には、再度署名する必要があります。署名済みの文書に再度署名した場合、Mage.exe では、古い署名が新しい署名で置換されます。
–AppManifest オプションを使用して配置マニフェストを作成した場合、Mage.exe は、配置マニフェストと同じディレクトリにアプリケーション マニフェストが存在し、サブディレクトリには現在の配置のバージョンから名前が付けてあると仮定して、配置マニフェストを適切に構成します。アプリケーション マニフェストを別の場所に格納する場合は、–AppCodeBase オプションを使用して、他の場所を設定します。
配置マニフェストおよびアプリケーション マニフェストは、アプリケーションを配置する前に、署名される必要があります。マニフェストに署名する方法については、「信頼されたアプリケーションの配置の概要」を参照してください。
アプリケーション マニフェストに –TrustLevel オプションを指定すると、アプリケーションをクライアント コンピュータで実行するために必要なアクセス許可セットが表示されます。既定では、アプリケーションの URL が存在するゾーンに基づいてアプリケーションに信頼レベルが割り当てられます。会社のネットワーク上にアプリケーションを配置する場合、アプリケーションは通常、イントラネット ゾーンに格納されます。一方、インターネット上にアプリケーションを配置する場合には、インターネット ゾーンに格納されます。どちらのセキュリティ ゾーンでも、アプリケーションからローカル リソースへのアクセスは制限されますが、イントラネット ゾーンはインターネット ゾーンに比べ、制限が少し緩くなっています。FullTrust ゾーンのアプリケーションの場合には、コンピュータのローカル リソースに制限なしでアクセスできます。–TrustLevel オプションを使用してアプリケーションのゾーンを指定すると、高いレベルの信頼を与えるかどうかを決定するように求めるメッセージが、CLR の Trust Manager コンポーネントによってユーザーに表示されます。会社のネットワーク上にアプリケーションを配置する場合は、信頼されたアプリケーションの配置を使用すると、ユーザーにメッセージで確認することなく、アプリケーションの信頼レベルを引き上げることができます。
アプリケーション マニフェストでは、カスタム信頼セクションもサポートされています。この機能では、アプリケーションの実行に必要な特定のアクセス許可だけを要求するマニフェストを構成できるため、最低限のアクセス許可を要求するセキュリティ プリンシパルにアプリケーションを従わせることができます。Mage.exe では、カスタム信頼セクションの追加は直接サポートされていません。カスタム信頼セクションを追加するには、テキスト エディタ、XML パーサー、またはグラフィカルなツールである MageGUI.exe を使用してください。MageGUI.exe を使用してカスタム信頼セクションを追加する方法の詳細については、「マニフェスト生成および編集ツールのグラフィカル クライアント (MageUI.exe)」を参照してください。
例
Mage 用のユーザー インターフェイス (MageUI.Exe) を開く例を次に示します。
mage
既定の配置マニフェストおよびアプリケーション マニフェストを作成する例を次に示します。これらのファイルは、すべて現在の作業ディレクトリに作成され、それぞれ deploy.application と application.exe.manifest という名前が付けられます。
mage –New Deployment
mage –New Application
mage –New TrustLicense
HelloWorld アプリケーション ディレクトリにあるすべてのアセンブリとすべてのリソース ファイルを含めたアプリケーション マニフェストを作成する例を次に示します。
mage –New Application –FromDirectory \bin -Version 1.0.0.0
前の例に続けて、配置名および対象のマイクロプロセッサを指定すると共に、ClickOnce で更新を確認する際の URL も指定する例を次に示します。
mage –New Application –FromDirectory \bin -Name "Hello, World! Application" –Version 1.0.0.0 –Processor "x86" –ProviderUrl http://internalserver/HelloWorld/
Internet Explorer でホストされる WPF アプリケーションを配置するための一組のマニフェストを作成する方法を次の例に示します。
mage –New Application –FromDirectory \bin -Version 1.0.0.0 -WPFBrowserApp true
mage -New Deployment -AppManifest 1.0.0.0\application.manifest -WPFBrowserApp true
アプリケーション マニフェストから取得した情報で配置マニフェストを更新し、アプリケーション マニフェストの場所のコード ベースを設定する例を次に示します。
mage –Update HelloWorld.deploy –AppManifest 1.0.0.0\application.manifest –AppCodeBase http://internalserver/HelloWorld.deploy
ユーザーがインストールしているバージョンを強制的に更新するように、配置マニフェストを更新する例を次に示します。
mage –Update c:\HelloWorldDeployment\HelloWorld.deploy –MinVersion 1.1.0.0
他のディレクトリからアプリケーション マニフェストを取得するように、配置マニフェストに指定する例を次に示します。
mage –Update HelloWorld.deploy –AppCodeBase http://anotherserver/HelloWorld/1.1.0.0/
現在の作業ディレクトリにあるデジタル証明書を使用して、既存の配置マニフェストに署名する例を次に示します。
mage –Sign deploy.application –CertFile cert.pfx –Password <passwd>
参照
処理手順
チュートリアル : ClickOnce アプリケーションを手動で配置する