マニフェストの生成および編集ツール (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 コマンド オプション」を参照してください。

New コマンド オプションと Update コマンド オプション

次の表は、–New コマンドおよび –Update コマンドでサポートされているオプションを示しています。

Sign コマンド オプション

次の表は、–Sign コマンドでサポートされているオプションを示しています。このコマンドは、すべての種類のファイルに適用されます。

解説

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 アプリケーションを手動で配置する

概念

信頼されたアプリケーションの配置の概要

参照

マニフェスト生成および編集ツールのグラフィカル クライアント (MageUI.exe)

SDK のコマンド プロンプト