From aea5e50466f90847b84295d8a1307b585813e2bf Mon Sep 17 00:00:00 2001 From: OpenLocalizationService Date: Fri, 2 Jun 2017 10:57:10 +0000 Subject: [PATCH] open localization: commit translated files --- .../assembly-security-considerations.md | 74 ++++++ .../create-and-use-strong-named-assemblies.md | 99 ++++++++ docs/framework/app-domains/index.md | 2 +- .../use-serviced-components-with-the-gac.md | 40 ++++ .../client-application-services.md | 85 +++++++ .../common-client-technologies/index.md | 2 +- docs/framework/deployment/index.md | 18 +- docs/framework/resources/index.md | 2 +- ...oftware-publisher-certificate-test-tool.md | 77 +++++++ .../tools/developer-command-prompt-for-vs.md | 106 +++++++++ docs/framework/tools/index.md | 2 +- .../tools/lc-exe-license-compiler.md | 116 ++++++++++ ...xe-manifest-generation-and-editing-tool.md | 217 ++++++++++++++++++ ...ation-and-editing-tool-graphical-client.md | 212 +++++++++++++++++ includes/dnprdnshort-md.md | 1 + includes/ndptecclick-md.md | 1 + includes/net-client-v40-long-md.md | 1 + includes/net-v20sp1-long-md.md | 1 + includes/net-v20sp1-short-md.md | 1 + includes/net-v35-long-md.md | 1 + includes/net-v35-short-md.md | 1 + includes/net-v35sp1-long-md.md | 1 + includes/netfx35-short-md.md | 1 + includes/sqprsqext-md.md | 1 + includes/ssew-md.md | 1 + includes/ssnoversion-md.md | 1 + includes/tla2sharptla-avalonwinfx-md.md | 1 + includes/tla2sharptla-clickonce-md.md | 1 + includes/tla2sharptla-lhsdk-md.md | 1 + includes/tla2sharptla-visualb-md.md | 1 + includes/tla2sharptla-visualstu-md.md | 1 + includes/tla2sharptla-visualstu2005-md.md | 1 + includes/tla2sharptla-wcsdk-md.md | 1 + includes/tla2sharptla-winfx-md.md | 1 + includes/tla2sharptla-winfxsdk-md.md | 1 + includes/tlasharptla-aspnet-md.md | 1 + includes/tlasharptla-clickonce-md.md | 1 + includes/tlasharptla-lhsdk-md.md | 1 + includes/tlasharptla-titlewinfx-md.md | 1 + includes/tlasharptla-winfxsdk-md.md | 1 + includes/vb-current-short-md.md | 1 + includes/vbprvb-md.md | 1 + includes/vbprvbext-md.md | 1 + includes/vbprvblong-md.md | 1 + includes/vbtecdlinq-md.md | 1 + includes/vs-current-short-md.md | 1 + includes/vs-dev10-long-md.md | 1 + includes/vs-dev11-ext-md.md | 1 + includes/vs-orcas-long-md.md | 1 + includes/vs-ordesigner-long-md.md | 1 + includes/vs2010-md.md | 1 + includes/vsprvs-md.md | 1 + includes/vsprvslong-md.md | 1 + includes/vstecasp-md.md | 1 + includes/winsdk-md.md | 1 + includes/winsdklong-md.md | 1 + includes/winsdkshort-md.md | 1 + 57 files changed, 1082 insertions(+), 13 deletions(-) create mode 100644 docs/framework/app-domains/assembly-security-considerations.md create mode 100644 docs/framework/app-domains/create-and-use-strong-named-assemblies.md create mode 100644 docs/framework/app-domains/use-serviced-components-with-the-gac.md create mode 100644 docs/framework/common-client-technologies/client-application-services.md create mode 100644 docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md create mode 100644 docs/framework/tools/developer-command-prompt-for-vs.md create mode 100644 docs/framework/tools/lc-exe-license-compiler.md create mode 100644 docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md create mode 100644 docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md create mode 100644 includes/dnprdnshort-md.md create mode 100644 includes/ndptecclick-md.md create mode 100644 includes/net-client-v40-long-md.md create mode 100644 includes/net-v20sp1-long-md.md create mode 100644 includes/net-v20sp1-short-md.md create mode 100644 includes/net-v35-long-md.md create mode 100644 includes/net-v35-short-md.md create mode 100644 includes/net-v35sp1-long-md.md create mode 100644 includes/netfx35-short-md.md create mode 100644 includes/sqprsqext-md.md create mode 100644 includes/ssew-md.md create mode 100644 includes/ssnoversion-md.md create mode 100644 includes/tla2sharptla-avalonwinfx-md.md create mode 100644 includes/tla2sharptla-clickonce-md.md create mode 100644 includes/tla2sharptla-lhsdk-md.md create mode 100644 includes/tla2sharptla-visualb-md.md create mode 100644 includes/tla2sharptla-visualstu-md.md create mode 100644 includes/tla2sharptla-visualstu2005-md.md create mode 100644 includes/tla2sharptla-wcsdk-md.md create mode 100644 includes/tla2sharptla-winfx-md.md create mode 100644 includes/tla2sharptla-winfxsdk-md.md create mode 100644 includes/tlasharptla-aspnet-md.md create mode 100644 includes/tlasharptla-clickonce-md.md create mode 100644 includes/tlasharptla-lhsdk-md.md create mode 100644 includes/tlasharptla-titlewinfx-md.md create mode 100644 includes/tlasharptla-winfxsdk-md.md create mode 100644 includes/vb-current-short-md.md create mode 100644 includes/vbprvb-md.md create mode 100644 includes/vbprvbext-md.md create mode 100644 includes/vbprvblong-md.md create mode 100644 includes/vbtecdlinq-md.md create mode 100644 includes/vs-current-short-md.md create mode 100644 includes/vs-dev10-long-md.md create mode 100644 includes/vs-dev11-ext-md.md create mode 100644 includes/vs-orcas-long-md.md create mode 100644 includes/vs-ordesigner-long-md.md create mode 100644 includes/vs2010-md.md create mode 100644 includes/vsprvs-md.md create mode 100644 includes/vsprvslong-md.md create mode 100644 includes/vstecasp-md.md create mode 100644 includes/winsdk-md.md create mode 100644 includes/winsdklong-md.md create mode 100644 includes/winsdkshort-md.md diff --git a/docs/framework/app-domains/assembly-security-considerations.md b/docs/framework/app-domains/assembly-security-considerations.md new file mode 100644 index 00000000000..15b857b19f5 --- /dev/null +++ b/docs/framework/app-domains/assembly-security-considerations.md @@ -0,0 +1,74 @@ +--- +title: "アセンブリのセキュリティに関する考慮事項 | Microsoft Docs" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-bcl +ms.tgt_pltfrm: +ms.topic: article +helpviewer_keywords: +- assemblies [.NET Framework], security +- signcodes +- names [.NET Framework], assemblies +- strong-named assemblies, security considerations +- signing assemblies +- assemblies [.NET Framework], signing +- granting permissions, assemblies +- assemblies [.NET Framework], strong-named +- names [.NET Framework], strong names +- permissions [.NET Framework], assemblies +- security [.NET Framework], assemblies +- integrity with assemblies +ms.assetid: 1b5439c1-f3d5-4529-bd69-01814703d067 +caps.latest.revision: 14 +author: rpetrusha +ms.author: ronpet +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: 9f5b8ebb69c9206ff90b05e748c64d29d82f7a16 +ms.openlocfilehash: 43953c223feb0a2035b60e589fbfca1ef411e6b9 +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# アセンブリのセキュリティに関する考慮事項 + アセンブリを作成する場合は、アセンブリの実行に必要となるアクセス許可セットを指定できます。 アセンブリに対して特定のアクセス許可を付与するかどうかは、証拠に基づいて決定されます。 + + 証拠には 2 つの使い方があります。 + +- 入力された証拠をローダーによって収集された証拠とマージして、ポリシーの解決に使用される最終的な証拠のセットを作成します。 この形式を使用するメソッドには、**Assembly.Load**、**Assembly.LoadFrom**、**Activator.CreateInstance** があります。 + +- 入力された証拠を変更せずに、ポリシーの解決に使用する最終的な証拠のセットとして使用します。 この形式を使用するメソッドには、**Assembly.Load(byte[])** と **AppDomain.DefineDynamicAssembly()** があります。 + + アセンブリが実行されるコンピューターで設定されている[セキュリティ ポリシー](../../../docs/framework/misc/code-access-security-basics.md)により、オプションのアクセス許可を与えることもできます。 発生する可能性があるセキュリティ例外をすべて処理するコードを作成するには、次のいずれかを行います。 + +- コードを実行するために必要なすべてのアクセス許可に対してアクセス許可要求を挿入し、アクセス許可が与えられなかった場合に生じる読み込み時エラーをあらかじめ処理しておく。 + +- コードを実行するために必要なアクセス許可を取得するためのアクセス許可要求は使用せず、アクセス許可が与えられなかった場合のセキュリティ例外を処理できるように準備しておく。 + + > [!NOTE] + > セキュリティは複雑な分野で、選択できるオプションも数多くあります。 詳細については、「[セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)」を参照してください。 + + アセンブリの読み込み時に、セキュリティ ポリシーへの追加情報としてアセンブリの証拠が使用されます。 セキュリティ ポリシーは、エンタープライズとコンピューターの管理者、およびユーザー ポリシー設定によって確立され、すべてのマネージ コードが実行されるときに与えられるアクセス許可セットを決定します。 セキュリティ ポリシーは、アセンブリの発行者 (署名ツールで生成されたシグネチャがある場合)、アセンブリのダウンロード元の Web サイトおよびゾーン (Internet Explorer の用語)、またはアセンブリの厳密な名前に対して設定できます。 たとえば、コンピューター管理者は、Web サイトからダウンロードされ、所定のソフトウェア企業の署名のあるすべてのコードについて、コンピューター上のデータベースへのアクセスは許可するが、ディスクへの書き込みは許可しない、というセキュリティ ポリシーを設定できます。 + +## 厳密な名前付きアセンブリと署名ツール + アセンブリには異なる、補完的な 2 つの方法で署名できます。厳密な名前を利用するか、[SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) を利用します。 厳密な名前を使用してアセンブリに署名すると、アセンブリ マニフェストを格納しているファイルに公開キー暗号化が追加されます。 厳密な名前による署名では、名前の一意性の検証を支援し、名前の悪用を防止し、参照が解決されたときに呼び出し元に ID を提供できます。 + + ただし、厳密な名前そのものには信頼性がないため、信頼性という点では [SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) が重要になります。 2 つの署名ツールでは、発行者が第三者機関に対して自分の身元を証明し、証明書を取得する必要があります。 取得した証明書はファイルに埋め込まれ、管理者はその証明書を使用してコードの正当性を信頼するかどうかを判断します。 + + アセンブリには、厳密な名前と [SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) を使用して作成されたデジタル署名の両方を与えるか、またはそのいずれか一方だけを適用できます。 2 つの署名ツールでは、署名できるファイルは一度に 1 つだけです。マルチファイル アセンブリの場合は、アセンブリ マニフェストを格納しているファイルに署名します。 厳密な名前はアセンブリ マニフェストが格納されているファイルに保存されますが、[SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) を使用して作成された署名は、アセンブリ マニフェストが格納されているポータブル実行可能 (PE: Portable Executable) ファイルの予約された専用スロットに保存されます。 [SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) を使用するアセンブリに対する署名は、[SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) で生成された署名に依存する信頼階層が既に存在する場合や、またはポリシーがキー部分だけを使用し、信頼階層はチェックしていない場合に、(厳密な名前と組み合わせて、または単独で) 使用できます。 + +> [!NOTE] +> アセンブリに対して厳密な名前と署名ツールの署名の両方を使用する場合は、厳密な名前を先に割り当てる必要があります。 + + 共通言語ランタイムは、ハッシュ検査も実行します。アセンブリ マニフェストには、アセンブリを構成するすべてのファイルのリストが格納されており、マニフェスト作成時の状態の各ファイルのハッシュも含まれています。 各ファイルが読み込まれたときに、その内容がハッシュされ、マニフェストに格納されているハッシュ値と比較されます。 2 つのハッシュが一致しない場合、アセンブリは読み込まれません。 + + 厳密な名前と [SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) を使用する署名によって整合性が保証されるため、これら 2 種類のアセンブリ証拠に基づいてコード アクセス セキュリティ ポリシーを設定できます。 厳密な名前と [SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) を使用する署名では、デジタル署名と証明書によって整合性が保証されます。 以上で述べた技術 (ハッシュ検査、厳密な名前、[SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) を使用する署名) をすべて組み合わせて使用することで、アセンブリがどのような方法によっても変更されていないことが保証されます。 + +## 関連項目 + [厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md) + [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md) + [SignTool.exe (署名ツール)](../../../docs/framework/tools/signtool-exe.md) diff --git a/docs/framework/app-domains/create-and-use-strong-named-assemblies.md b/docs/framework/app-domains/create-and-use-strong-named-assemblies.md new file mode 100644 index 00000000000..c55875ee4a1 --- /dev/null +++ b/docs/framework/app-domains/create-and-use-strong-named-assemblies.md @@ -0,0 +1,99 @@ +--- +title: "厳密な名前付きアセンブリの作成と使用 | Microsoft Docs" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-bcl +ms.tgt_pltfrm: +ms.topic: article +helpviewer_keywords: +- strong-name bypass feature +- strong-named assemblies, about strong-named assemblies +- strong-named assemblies +- signing assemblies +- assemblies [.NET Framework], signing +- strong-named assemblies, scenarios +- assemblies [.NET Framework], strong-named +- strong-named assemblies, loading into trusted application domains +- assembly binding, strong-named +ms.assetid: ffbf6d9e-4a88-4a8a-9645-4ce0ee1ee5f9 +caps.latest.revision: 17 +author: rpetrusha +ms.author: ronpet +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: 9f5b8ebb69c9206ff90b05e748c64d29d82f7a16 +ms.openlocfilehash: 7c694fc26d65fee277c7a6873494c8d1900408b2 +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# 厳密な名前付きアセンブリの作成と使用 + 厳密な名前は、単純テキスト名、バージョン番号、カルチャ情報 (設定されている場合) から成るアセンブリの識別子と、公開キーおよびデジタル署名で構成されます。 このデジタル署名は、対応する秘密キーを使用してアセンブリ ファイルから生成されます。 (アセンブリ ファイルにはアセンブリ マニフェストが格納されており、そこに、アセンブリを構成するすべてのファイルの名前とハッシュが含まれます。) + + 厳密な名前のアセンブリは、他の厳密な名前のアセンブリでのタイプだけを使用できます。 それ以外の場合は、厳密な名前のアセンブリのセキュリティが損なわれます。 + + この概要は、次のセクションで構成されています。 + +- [厳密な名前のシナリオ](#strong_name_scenario) + +- [信頼されたアセンブリの署名検証のバイパス](#bypassing_signature_verification) + +- [関連トピック](#related_topics) + + +## 厳密な名前のシナリオ + 次のシナリオは、厳密な名前のアセンブリに署名した後にそれをその名前で参照するプロセスの概要を示しています。 + +1. アセンブリ A は、次のいずれかの方法を使用して厳密な名前で作成されます。 + + - [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] など、厳密な名前の作成をサポートする開発環境を使用する。 + + - [厳密名ツール (Sn.exe)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) を使用して暗号化キー ペアを作成し、コマンド ライン コンパイラまたは[アセンブリ リンカー (Al.exe)](../../../docs/framework/tools/al-exe-assembly-linker.md) のいずれかを使用してそのキー ペアをアセンブリに割り当てる。 Windows ソフトウェア開発キット (SDK) には、Sn.exe と Al.exe の両方が用意されています。 + +2. 開発環境またはツールは、アセンブリのマニフェストを含むファイルのハッシュに、開発者の秘密キーで署名します。 このデジタル署名は、アセンブリ A のマニフェストを含むポータブル実行可能 (PE) ファイルに格納されます。 + +3. アセンブリ B はアセンブリ A のコンシューマーです。アセンブリ B のマニフェストの参照セクションには、アセンブリ A の公開キーを表すトークンが含まれています。 トークンは完全な公開キーの一部であり、スペースを節約するために、キー自体ではなくこれが使用されます。 + +4. 共通言語ランタイムは、アセンブリがグローバル アセンブリ キャッシュに入れられる際に、厳密な名前の署名を確認します。 実行時に厳密な名前でバインドするとき、共通言語ランタイムは、アセンブリ B のマニフェストに格納されているキーと、アセンブリ A の厳密な名前を生成するために使用されたキーを比較します。.NET Framework のセキュリティ チェックに合格してバインドが成功すると、アセンブリ B は、アセンブリ A のビットが改ざんされていないことと、これらのビットが実際にアセンブリ A の開発者からのものであることが保証されます。 + +> [!NOTE] +> このシナリオは、信頼の問題を扱っていません。 厳密な名前に加えて、完全な Microsoft Authenticode 署名をアセンブリに持たせることができます。 Authenticode 署名には、信頼を確立するための証明書が含まれます。 厳密な名前を使用すると、コードにこのように署名する必要がないということに注意してください。 実際に、厳密な名前の署名の生成に使用されるキーは、Authenticode 署名の生成に使用されるキーと同じである必要はありません。 + + [ページのトップへ](#top) + + +## 信頼されたアセンブリの署名検証のバイパス + [!INCLUDE[net_v35SP1_long](../../../includes/net-v35sp1-long-md.md)] 以降、たとえば `MyComputer` ゾーンの既定のアプリケーション ドメインなど、完全に信頼されたアプリケーション ドメインにアセンブリが読み込まれるときに、厳密な名前の署名は検証されなくなりました。 これは厳密な名前のバイパス機能と呼ばれます。 完全に信頼された環境では、 に対する完全に信頼された署名済みアセンブリの要求は、その署名に関係なく、常に成功します。 このような場合、厳密な名前のバイパス機能は、完全に信頼されたアセンブリの厳密名署名検証という不要なオーバーヘッドを回避するので、アセンブリを高速で読み込むことができます。 + + バイ パス機能は、厳密な名前で署名されていて、次の特性を持つアセンブリに適用されます。 + +- 証拠なしで完全に信頼されている (たとえば、`MyComputer` ゾーン証拠を持っている)。 + +- 完全に信頼された に読み込まれる。 + +- その の プロパティに基づいた場所から読み込まれる。 + +- 遅延署名されていない。 + + この機能は、個々のアプリケーションに対して、またはコンピューターに対して無効にすることができます。 「[方法: 厳密な名前のバイパス機能を無効にする](../../../docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md)」を参照してください。 + + [ページのトップへ](#top) + + +## 関連トピック + +|タイトル|説明| +|-----------|-----------------| +|[方法: 公開キーと秘密キーのキー ペアを作成する](../../../docs/framework/app-domains/how-to-create-a-public-private-key-pair.md)|署名とアセンブリの暗号化キー ペアを作成する方法について説明します。| +|[方法: 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)|厳密な名前のアセンブリを作成する方法について説明します。| +|[拡張された厳密な名前付け](../../../docs/framework/app-domains/enhanced-strong-naming.md)|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] での厳密な名前の拡張について説明します。| +|[方法 : 厳密な名前のアセンブリを参照する](../../../docs/framework/app-domains/how-to-reference-a-strong-named-assembly.md)|コンパイル時または実行時に厳密な名前のアセンブリでタイプまたはリソースを参照する方法について説明します。| +|[方法: 厳密な名前のバイパス機能を無効にする](../../../docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md)|厳密な名前の署名の検証をバイパスする機能を無効にする方法について説明します。 すべてのまたは特定のアプリケーションに対して、この機能を無効にすることができます。| +|[アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)|単一ファイル アセンブリおよびマルチファイル アセンブリの概要を示します。| +|[NIB: 方法 : アセンブリの遅延署名 (Visual Studio)](http://msdn.microsoft.com/en-us/cab63b7a-591e-4674-b236-d77cd29a79ea)|アセンブリを作成した後に厳密な名前でアセンブリに署名する方法について説明します。| +|[Sn.exe (厳密名ツール)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)|厳密な名前のアセンブリの作成に役立つ、.NET Framework に付属のツールについて説明します。 このツールには、キーの管理、署名の生成、署名の検査に関する各オプションが用意されています。| +|[Al.exe (アセンブリ リンカー)](../../../docs/framework/tools/al-exe-assembly-linker.md)|モジュールまたはリソース ファイルからアセンブリ マニフェストを含むファイルを生成する、.NET Framework に付属のツールについて説明します。| diff --git a/docs/framework/app-domains/index.md b/docs/framework/app-domains/index.md index 15da56a5c34..ddb5fd42feb 100644 --- a/docs/framework/app-domains/index.md +++ b/docs/framework/app-domains/index.md @@ -23,7 +23,7 @@ ms.translationtype: Machine Translation ms.sourcegitcommit: 9f5b8ebb69c9206ff90b05e748c64d29d82f7a16 ms.openlocfilehash: 1cfd73bf6d8de9ea4ff9854e6882683514cb3c56 ms.contentlocale: ja-jp -ms.lasthandoff: 05/22/2017 +ms.lasthandoff: 06/02/2017 --- # アプリケーション ドメインとアセンブリを使用したプログラミング diff --git a/docs/framework/app-domains/use-serviced-components-with-the-gac.md b/docs/framework/app-domains/use-serviced-components-with-the-gac.md new file mode 100644 index 00000000000..2152be728cf --- /dev/null +++ b/docs/framework/app-domains/use-serviced-components-with-the-gac.md @@ -0,0 +1,40 @@ +--- +title: "サービス コンポーネントとグローバル アセンブリ キャッシュの使用 | Microsoft ドキュメント" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-bcl +ms.tgt_pltfrm: +ms.topic: article +helpviewer_keywords: +- assemblies [.NET Framework], global assembly cache +- GAC (global assembly cache), serviced components +- serviced components, global assembly cache +- global assembly cache, serviced components +ms.assetid: 3423e5d9-234c-4571-8161-e35f6d130128 +caps.latest.revision: 8 +author: rpetrusha +ms.author: ronpet +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: 9f5b8ebb69c9206ff90b05e748c64d29d82f7a16 +ms.openlocfilehash: b94461096bfcf72d2a7ee8bc8b0847e2f753161b +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# サービス コンポーネントとグローバル アセンブリ キャッシュの使用 +サービス コンポーネント (マネージ COM+ コンポーネント) はグローバル アセンブリ キャッシュに配置する必要があります。 共通言語ランタイムと COM+ サービスは、シナリオによって、グローバル アセンブリ キャッシュに配置されていないサービス コンポーネントを処理できる場合と、処理できない場合があります。 これについて、次のシナリオで説明します。 + +- COM+ サーバー アプリケーションに含まれるサービス コンポーネントの場合、コンポーネントが含まれるアセンブリがグローバル アセンブリ キャッシュに配置されている必要があります。これは、Dllhost.exe がサービス コンポーネントを格納するのと同じディレクトリで実行されないためです。 + +- COM+ ライブラリ アプリケーションに含まれるサービス コンポーネントの場合、ランタイムと COM+ サービスは、現在のディレクトリで検索することにより、コンポーネントを含むアセンブリへの参照を解決できます。 この場合、アセンブリがグローバル アセンブリ キャッシュ内に配置されている必要はありません。 + +- ASP.NET アプリケーションに含まれるサービス コンポーネントの場合、状況は異なります。 サービス コンポーネントを含むアセンブリをアプリケーション ベースの bin ディレクトリに配置し、オンデマンド登録を使用すると、アセンブリはダウンロード キャッシュにシャドウとしてコピーされます。これは、ASP.NET がランタイムのシャドウ機能を利用するためです。 + +## 関連項目 + [アセンブリとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/working-with-assemblies-and-the-gac.md) + [Gacutil.exe (グローバル アセンブリ キャッシュ ツール)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) diff --git a/docs/framework/common-client-technologies/client-application-services.md b/docs/framework/common-client-technologies/client-application-services.md new file mode 100644 index 00000000000..a34899e12fc --- /dev/null +++ b/docs/framework/common-client-technologies/client-application-services.md @@ -0,0 +1,85 @@ +--- +title: "クライアント アプリケーション サービス | Microsoft Docs" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-clr +ms.tgt_pltfrm: +ms.topic: article +helpviewer_keywords: +- role-based security [.NET Framework], client application services +- client application services +- credentials [.NET Framework] +- Windows-based applications, client application services +- application settings, client application services +- profiles [ASP.NET], client application services +- logins [client application services] +- sharing information and functionality [client application services] +- Web settings [client application services] +- authentication [ASP.NET], client application services +- ASP.NET services, client application services +- client applications, ASP.NET services +- roles [.NET Framework], client application services +- client application services, about client application services +ms.assetid: 1487d8df-089e-4f21-abfb-a791a652b58e +caps.latest.revision: 14 +author: dotnet-bot +ms.author: dotnetcontent +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: 3ec7d3a3cf4c43349f0a10cac95cff507b59cfc5 +ms.openlocfilehash: 227c163bcdeb26d7bd4dd005e7e872300d58a2c3 +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# クライアント アプリケーション サービス +クライアント アプリケーション サービスにより、Microsoft ASP.NET 2.0 AJAX Extensions に含まれる [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] のログイン、ロール、およびプロファイル アプリケーション サービスを使用する Windows ベースのアプリケーションを簡単に作成できます。 これらのサービスにより、複数の Web ベースおよび Windows ベースのアプリケーションで、単一のサーバーから提供されるユーザー情報とユーザー管理機能を共有できます。 たとえば、これらのサービスを使用して、次のタスクを実行できます。 + +- ユーザーを認証します。 認証サービスを使用して、ユーザー ID を検証することができます。 + +- 認証されたユーザーのロールを確認します。 ロール サービスを使用して、ユーザーのロールに応じてアプリケーションのユーザー インターフェイスを変更できます。 たとえば、管理者ロールのユーザーには機能を追加して提供することができます。 + +- サーバー上に存在する、ユーザーごとのアプリケーションの設定を保存してアクセスします。 Web 設定サービス (プロファイル サービスとも呼ばれます) を使用して、複数のアプリケーションや場所で設定を共有することができます。 + + クライアント アプリケーション サービスは、アプリケーション構成ファイルで指定できるクライアントのサービス プロバイダーの Web サービス拡張モデルを活用します。 これらのサービス プロバイダーには、ネットワーク接続が利用できない場合、認証、ロール、および設定のデータのローカル キャッシュを使用するオフライン機能が含まれます。 + + [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] アプリケーション サービスの詳細については、「[ASP.NET アプリケーション サービスの概要](http://msdn.microsoft.com/library/1162e529-0d70-44b2-b3ab-83e60c695013)」を参照してください。 + +## このセクションの内容 + [クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md) + クライアント アプリケーション サービス プロバイダーを介して使用できる機能について説明します。 + + [方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md) + このトピックでは、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] プロジェクト デザイナーを使用して、アプリケーション サービスを有効にし、構成する方法について説明します。 対応する App.config ファイルへの変更についても説明します。 + + [方法: クライアント アプリケーション サービスでユーザーのログインを実装する](../../../docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md) + アプリケーションがクライアントの認証サービス プロバイダーを使用するよう構成される場合のユーザー検証方法について説明します。 + + [チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md) + すべてのクライアント アプリケーション サービスの機能を1 つのアプリケーションに結合する方法について説明します。 このチュートリアルでは、エンド ツー エンドのガイダンスを示します。 たとえば、クライアント アプリケーション サービスのテストに使用できる ASP.NET Web サービス アプリケーションを作成する方法の手順が含まれます。 + +## 参照 + + + + + + + + + + + + +## 関連項目 + [ASP.NET アプリケーション サービスの概要](http://msdn.microsoft.com/library/1162e529-0d70-44b2-b3ab-83e60c695013) + [ASP.NET AJAX でのフォーム認証の使用](http://msdn.microsoft.com/library/c50f7dc5-323c-4c63-b4f3-96edfc1e815e) + [ASP.NET AJAX でのロール情報の使用](http://msdn.microsoft.com/library/280f6ad9-ba1a-4fc9-b0cc-22e39e54a82d) + [ASP.NET AJAX でのプロファイル情報の使用](http://msdn.microsoft.com/library/91239ae6-d01c-4f4e-a433-eb9040dbed61) + [ASP.NET の認証](http://msdn.microsoft.com/library/fc10b0ef-4ce4-4a7f-9174-886325221ee1) + [ロールを使用した承認の管理](http://msdn.microsoft.com/library/01954ce4-39a2-487f-8153-a69f6f6f3195) + [アプリケーション設定の概要](../../../docs/framework/winforms/advanced/application-settings-overview.md) diff --git a/docs/framework/common-client-technologies/index.md b/docs/framework/common-client-technologies/index.md index 9ef43ce6ae1..fa5e29d1f04 100644 --- a/docs/framework/common-client-technologies/index.md +++ b/docs/framework/common-client-technologies/index.md @@ -18,7 +18,7 @@ ms.translationtype: Machine Translation ms.sourcegitcommit: 9f5b8ebb69c9206ff90b05e748c64d29d82f7a16 ms.openlocfilehash: 33735d01f33adc5fc2299c0a83a4208a28fc6b2d ms.contentlocale: ja-jp -ms.lasthandoff: 05/22/2017 +ms.lasthandoff: 06/02/2017 --- # .NET Framework の共通クライアント技術 diff --git a/docs/framework/deployment/index.md b/docs/framework/deployment/index.md index 1542f70c952..25a7b088ba7 100644 --- a/docs/framework/deployment/index.md +++ b/docs/framework/deployment/index.md @@ -26,11 +26,11 @@ caps.latest.revision: 56 author: mairaw ms.author: mairaw manager: wpickett -ms.translationtype: Human Translation -ms.sourcegitcommit: 3dbadeec14ce9c023af39ae4ff95d0183826e7c1 -ms.openlocfilehash: eb0f0636abb39eabb387388fcdd39df8aca88c34 +ms.translationtype: Machine Translation +ms.sourcegitcommit: fe9ab371ab8d3eee3778412e446b7aa30b42476b +ms.openlocfilehash: 46f524a8c2ee2d65d5c756a101a5c26c5919e165 ms.contentlocale: ja-jp -ms.lasthandoff: 05/02/2017 +ms.lasthandoff: 06/02/2017 --- # .NET Framework およびアプリケーションの配置 @@ -57,13 +57,13 @@ ms.lasthandoff: 05/02/2017 - [.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md) - - [.NET Framework のインストールとアンインストールのブロックに関するトラブルシューティング](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) + - [.NET Framework のインストールおよびアンインストールのブロックのトラブルシューティング](~/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md) - .NET Framework とクライアント アプリケーションの配置 (開発者向け): - - セットアップと配置プロジェクトでの [InstallShield の使用](../../../docs/framework/deployment/deployment-guide-for-developers.md#installshield) + - セットアップと配置プロジェクトでの [InstallShield の使用](../../../docs/framework/deployment/deployment-guide-for-developers.md#installshield-deployment) - - [Visual Studio の ClickOnce アプリケーションの使用](../../../docs/framework/deployment/deployment-guide-for-developers.md#clickonce) + - [Visual Studio の ClickOnce アプリケーションの使用](../../../docs/framework/deployment/deployment-guide-for-developers.md#clickonce-deployment) - [WiX インストール パッケージの作成](../../../docs/framework/deployment/deployment-guide-for-developers.md#wix) @@ -171,12 +171,12 @@ ms.lasthandoff: 05/02/2017 |タイトル|説明| |-----------|-----------------| |[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)|共通言語ランタイムが、バインド要求を満たすために、使用するアセンブリをどのように特定するかを説明します。| -|[アセンブリの読み込みのベスト プラクティス](../../../docs/framework/deployment/best-practices-for-assembly-loading.md)|、、その他のエラーなどの原因となることがある型 ID の問題を回避する方法について説明します。| +|[アセンブリの読み込みのベスト プラクティス](../../../docs/framework/deployment/best-practices-for-assembly-loading.md)|、、およびその他のエラーの原因となることがある型 ID の問題を回避する方法について説明します。| |[.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)|再起動をできる限り回避する再起動マネージャーと、.NET Framework をインストールするアプリケーションがそれをどのように利用できるかを説明しています。| |[配置ガイド (管理者向け)](../../../docs/framework/deployment/guide-for-administrators.md)|System Center Configuration Manager (SCCM) を使用したシステム管理者による .NET Framework の配置方法と、ネットワーク全体でのシステムの依存関係について説明します。| |[配置ガイド (開発者向け)](../../../docs/framework/deployment/deployment-guide-for-developers.md)|開発者による .NET Framework とアプリケーションのユーザーのコンピューターへのインストール方法について説明します。| |[アプリケーション、サービス、およびコンポーネントの配置](https://docs.microsoft.com/visualstudio/deployment/deploying-applications-services-and-components)|ClickOnce を使用したアプリケーションの発行手順や、Windows インストーラー テクノロジなど、Visual Studio の配置オプションについて説明します。| -|[ClickOnce アプリケーションの発行](http://msdn.microsoft.com/library/eb6dfe79-f54c-4331-8e36-073688e70973)|Windows フォーム アプリケーションをパッケージ化し、これを ClickOnce でネットワーク上のクライアント コンピューターに配置する方法を説明します。| +|[ClickOnce アプリケーションの発行](/visualstudio/deployment/publishing-clickonce-applications)|Windows フォーム アプリケーションをパッケージ化し、これを ClickOnce でネットワーク上のクライアント コンピューターに配置する方法を説明します。| |[リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)|.NET Framework でリソースのパッケージ化と配置に使用する、ハブ アンド スポーク モデルについて説明します。リソースの名前付け規則、フォールバック プロセス、およびパッケージ化の代替策についても説明します。| |[相互運用アプリケーションの配置](../../../docs/framework/interop/deploying-an-interop-application.md)|相互運用アプリケーションの出荷方法とインストール方法について説明します。通常、相互運用アプリケーションには、.NET Framework クライアント アセンブリ、個別の COM タイプ ライブラリを表す 1 つ以上の相互運用機能アセンブリ、および 1 つ以上の登録済み COM コンポーネントが含まれています。| |[方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)|進行状況のビューを独自に表示する一方で、.NET Framework セットアップ プロセスをサイレントで起動および追跡する方法を説明します。| diff --git a/docs/framework/resources/index.md b/docs/framework/resources/index.md index 463be8e80bc..520145c24a7 100644 --- a/docs/framework/resources/index.md +++ b/docs/framework/resources/index.md @@ -26,7 +26,7 @@ ms.translationtype: Machine Translation ms.sourcegitcommit: 9f5b8ebb69c9206ff90b05e748c64d29d82f7a16 ms.openlocfilehash: ffe0b574b00e3ce420d83658f5844f26c3f8ea72 ms.contentlocale: ja-jp -ms.lasthandoff: 05/22/2017 +ms.lasthandoff: 06/02/2017 --- # デスクトップ アプリケーションのリソース diff --git a/docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md b/docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md new file mode 100644 index 00000000000..c4a7b76f384 --- /dev/null +++ b/docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md @@ -0,0 +1,77 @@ +--- +title: "Cert2spc.exe (ソフトウェア発行元証明書テスト ツール) | Microsoft Docs" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-clr +ms.tgt_pltfrm: +ms.topic: article +dev_langs: +- VB +- CSharp +- C++ +- jsharp +helpviewer_keywords: +- SPC +- Software Publisher Certificate Test tool +- Software Publisher Certificate +- Cert2spc.exe +- certificates, Software Publisher's Certificate +ms.assetid: be434d7d-9c0d-46e7-8392-58a9b542d11d +caps.latest.revision: 21 +author: rpetrusha +ms.author: ronpet +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: 14abadaf548e228244a1ff7ca72fa3896ef4eb5d +ms.openlocfilehash: 4d78c7d33061cb60acf494097c2bc642526a562a +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# Cert2spc.exe (ソフトウェア発行元証明書テスト ツール) +ソフトウェア発行元証明書テスト ツールは、1 つ以上の X.509 証明書からソフトウェア発行元証明書 (SPC: Software Publisher's Certificate) を作成します。 Cert2spc.exe はテスト専用のツールです。 有効な SPC は、VeriSign や Thawte などの証明書発行機関から入手できます。 X.509 証明書の作成の詳細については、「[Makecert.exe (証明書作成ツール)](http://msdn.microsoft.com/library/b0343f8e-9c41-4852-a85c-f8a0c408cf0d)」を参照してください。 + + このツールは、Visual Studio と共に自動的にインストールされます。 このツールを実行するには、開発者コマンド プロンプト (または、Windows 7 の Visual Studio コマンド プロンプト) を使用します。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。 + + コマンド プロンプトに次のように入力します。 + +## 構文 + +``` +cert2spc cert1.cer | crl1.crl [... certN.cer | crlN.crl] outputSPCfile.spc +``` + +#### パラメーター + +|引数|説明| +|--------------|-----------------| +|`certN.cer`|SPC ファイルに組み込む X.509 証明書の名前。 スペースで区切ることによって、複数の名前を指定できます。| +|`crlN.crl`|SPC ファイルに組み込む証明書失効リストの名前。 スペースで区切ることによって、複数の名前を指定できます。| +|`outputSPCfile.spc`|X.509 証明書が格納される PKCS #7 オブジェクトの名前。| + +|オプション|説明| +|------------|-----------------| +|**/?**|このツールのコマンド構文とオプションを表示します。| + +## 例 + `myCertificate.cer` から SPC を作成し、`mySPCFile.spc` に格納するコマンドを次に示します。 + +``` +cert2spc myCertificate.cer mySPCFile.spc +``` + + `oneCertificate.cer` と `twoCertificate.cer` から SPC を作成し、`mySPCFile.spc` に格納するコマンドを次に示します。 + +``` +cert2spc oneCertificate.cer twoCertificate.cer mySPCFile.spc +``` + +## 関連項目 + [.NET Framework ツール](../../../docs/framework/tools/index.md) + [Makecert.exe (証明書作成ツール)](http://msdn.microsoft.com/library/b0343f8e-9c41-4852-a85c-f8a0c408cf0d) + [Visual Studio 用開発者コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md) + diff --git a/docs/framework/tools/developer-command-prompt-for-vs.md b/docs/framework/tools/developer-command-prompt-for-vs.md new file mode 100644 index 00000000000..157f4002b7b --- /dev/null +++ b/docs/framework/tools/developer-command-prompt-for-vs.md @@ -0,0 +1,106 @@ +--- +title: "Visual Studio 用開発者コマンド プロンプト | Microsoft Docs" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-clr +ms.tgt_pltfrm: +ms.topic: article +dev_langs: +- VB +- CSharp +- C++ +- jsharp +helpviewer_keywords: +- command prompt, Windows SDK +- Visual Studio command prompt +- command prompt, Visual Studio +- SDK command prompt +- tools [.NET Framework], setting environment variables +- environment variables, setting for tools +- developer command prompt +ms.assetid: 94fcf524-9045-4993-bfb2-e2d8bad44219 +caps.latest.revision: 45 +author: mairaw +ms.author: mairaw +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: fe32676f0e39ed109a68f39584cf41aec5f5ce90 +ms.openlocfilehash: 6138fab11f30fdee646768ce807fbdba57fcabb3 +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# Visual Studio 用開発者コマンド プロンプト +Visual Studio の開発者コマンド プロンプトでは、.NET Framework ツールを使いやすくするための環境変数が自動的に設定されます。 開発者コマンド プロンプトは、完全版または Community Edition の Visual Studio でインストールされます。 Express バージョンの Visual Studio ではインストールされません。 + + +## コンピューター上でのコマンド プロンプトの検索 + Visual Studio のバージョンと、インストールした追加の SDK に応じて、複数のコマンド プロンプトが表示される場合があります。 たとえば、Visual Studio の 64 ビット バージョンには、32 ビットと 64 ビットのコマンド プロンプトが用意されています (ほとんどのツールでは、32 ビット バージョンと 64 ビット バージョンに違いはありませんが、一部のツールでは、32 ビット環境と 64 ビット環境に固有の変更が加えられています)。次の手順でうまくいかない場合は、「[コンピューター上のファイルを手動で探す](#alternative)」または「[Visual Studio 内からコマンド プロンプトを実行する](#visualstudio)」を試してください。 + + **Windows 10 の場合** + +1. キーボードの Windows ロゴ キー ![Windows ロゴ](../../../docs/framework/get-started/media/windowskeyboardlogo.png "Windowskeyboardlogo") を押すなどして、**[スタート]** メニューを開きます。 + +2. **[スタート]** メニューで、「`dev`」と入力します。 これにより、検索パターンに一致する、インストールされているアプリの一覧が表示されます。 別のコマンド プロンプトを探す場合は、別の検索語句 (「`prompt`」など) を入力してください。 + +3. **[開発者コマンド プロンプト]** (または、使用するコマンド プロンプト) を選択します。 + + **Windows 8.1 の場合** + +1. キーボードの Windows ロゴ キー ![Windows ロゴ](../../../docs/framework/get-started/media/windowskeyboardlogo.png "Windowskeyboardlogo") を押すなどして、**[スタート]** 画面に移動します。 + +2. **[スタート]** 画面で、`CTRL + TAB` キーを押して **[アプリ]** 一覧を開き、「`V`」と入力します。 これにより、インストールされているすべての Visual Studio コマンド プロンプトが含まれた一覧が表示されます。 + +3. **[開発者コマンド プロンプト]** (または、使用するコマンド プロンプト) を選択します。 + + **Windows 8 の場合** + +1. キーボードの Windows ロゴ キー ![Windows ロゴ](../../../docs/framework/get-started/media/windowskeyboardlogo.png "Windowskeyboardlogo") を押すなどして、**[スタート]** 画面に移動します。 + +2. **[スタート]** 画面で、Windows ロゴ キー ![Windows ロゴ](../../../docs/framework/get-started/media/windowskeyboardlogo.png "Windowskeyboardlogo") `+ Z` を押します。 + +3. 画面下部にある**アプリ ビュー** アイコンを選択し、「`V`」と入力します。 これにより、インストールされているすべての Visual Studio コマンド プロンプトが含まれた一覧が表示されます。 + +4. **[開発者コマンド プロンプト]** (または、使用するコマンド プロンプト) を選択します。 + + **Windows 7 の場合** + +1. **[スタート]** を選択し、**[すべてのプログラム]**、**[Microsoft Visual Studio]** の順に展開します。 + +2. インストールされている Visual Studio のバージョンに応じて、**[Visual Studio Tools]**、**[Visual Studio コマンド プロンプト]**、または使用するコマンド プロンプトを選択します。 + + [Windows SDK](http://msdn.microsoft.com/windows/desktop/aa904949) または [Windows Phone SDK](https://dev.windowsphone.com/downloadsdk) をインストールしている場合は、ARM、x86、または x64 の各アーキテクチャ用のコマンド プロンプトがさらに表示される場合があります。 各ツールのドキュメントを参照して、どのバージョンのコマンド プロンプトを使用する必要があるかを確認してください。 + + +## コンピューター上のファイルを手動で探す + インストール済みのコマンド プロンプトのショートカットは、通常 Visual Studio の **[スタート] メニュー**用のフォルダー (C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio 2015\Visual Studio Tools 内など) にあります。 ただし、コマンド プロンプトを探しても、何らかの理由によって期待した結果を得られない場合は、そのショートカットを使用するために、コンピューター上でそのショートカットを手動で探すことができます。 VsDevCmd.bat などのコマンド プロンプトのファイル名を検索するか、または Tools フォルダー (C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools など) に移動します (パスは、Visual Studio のバージョンとインストール先に応じて変わります)。 + + +## Visual Studio 内からコマンド プロンプトを実行する + 簡単にアクセスできるように、Visual Studio の開発者コマンド プロンプトまたは他のコマンド プロンプトを Visual Studio の [ツール] メニューに追加することができます。このためには、[外部ツール一覧] にそのコマンド プロンプトを追加します。 この追加を行う方法は、次のとおりです。 + +1. Visual Studio を開きます。 + +2. **[ツール]** メニューを選択し、**[外部ツール...]** をクリックします。 + +3. **[外部ツール]** ダイアログ ボックスで、**[追加]** ボタンをクリックします。 新しいエントリが表示されます + +4. 新しいメニュー項目の **[タイトル]** を入力します (「`Command Prompt`」など)。 + +5. **[コマンド]** フィールドに、起動するファイル (`%comspec%` や `C:\Windows\System32\cmd.exe` など) を指定します。 + +6. **[引数]** フィールドに、使用する特定のコマンド プロンプトのある場所を指定します (`/k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools\VsDevCmd.bat"` など (これにより、[!INCLUDE[vs_dev14](../../../includes/vs-dev14-md.md)] でインストールされた開発者コマンド プロンプトが起動されます))。 この値は、Visual Studio のバージョンとインストール先に応じて変更する必要があります。 + +7. **[初期ディレクトリ]** フィールドの値 (**[プロジェクト ディレクトリ]** など) を選択します。 + +8. **[OK]** を選択します。 + + この後、新しいメニュー項目が追加され、このコマンド プロンプトに **[ツール]** メニューからアクセスできるようになります。 + +## 関連項目 + [.NET Framework ツール](../../../docs/framework/tools/index.md) + [Visual Studio の外部ツール](/visualstudio/ide/managing-external-tools) diff --git a/docs/framework/tools/index.md b/docs/framework/tools/index.md index 19c50fd7cc7..5835cb5c47d 100644 --- a/docs/framework/tools/index.md +++ b/docs/framework/tools/index.md @@ -28,7 +28,7 @@ ms.translationtype: Machine Translation ms.sourcegitcommit: 9f5b8ebb69c9206ff90b05e748c64d29d82f7a16 ms.openlocfilehash: baaf365a21661b377f8151e5d97ac16542aa2c36 ms.contentlocale: ja-jp -ms.lasthandoff: 05/22/2017 +ms.lasthandoff: 06/02/2017 --- # .NET Framework ツール diff --git a/docs/framework/tools/lc-exe-license-compiler.md b/docs/framework/tools/lc-exe-license-compiler.md new file mode 100644 index 00000000000..73494c2aa51 --- /dev/null +++ b/docs/framework/tools/lc-exe-license-compiler.md @@ -0,0 +1,116 @@ +--- +title: "Lc.exe (ライセンス コンパイラ) | Microsoft Docs" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-clr +ms.tgt_pltfrm: +ms.topic: article +dev_langs: +- VB +- CSharp +- C++ +- jsharp +helpviewer_keywords: +- Lc.exe +- .licx file +- License Compiler +- control licenses [Windows Forms] +- compiling licenses file +- license file +- .licenses file +- Windows Forms, control licenses +- licensed controls [Windows Forms] +ms.assetid: 2de803b8-495e-4982-b209-19a72aba0460 +caps.latest.revision: 18 +author: dotnet-bot +ms.author: dotnetcontent +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: 14abadaf548e228244a1ff7ca72fa3896ef4eb5d +ms.openlocfilehash: 4b20c589622526fd973700ed5b8bdd6f86d9b2ff +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# Lc.exe (ライセンス コンパイラ) +ライセンス コンパイラは、ライセンス情報を含むテキスト ファイルを読み込んで、バイナリ ファイルを生成します。このバイナリ ファイルは、リソースとして共通言語ランタイムの実行可能ファイルに埋め込むことができます。 + + .licx テキスト ファイルは、ライセンスされたコントロールがフォームに追加されると、Windows フォーム デザイナーによって自動的に生成または更新されます。 プロジェクト システムは、コンパイルの過程で、.licx テキスト ファイルを、.NET のコントロール ライセンス サポートを提供する .licenses バイナリのリソースに変換します。 バイナリのリソースは、その後、プロジェクト出力に埋め込まれます。 + + プロジェクトをビルドするときにライセンス コンパイラを使用した場合は、32 ビットと 64 ビットの間のクロス コンパイルはサポートされません。 これは、ライセンス コンパイラはアセンブリを読み込む必要があり、32 ビット アプリケーションからの 64 ビット アセンブリの読み込みおよびその逆は、許可されないためです。 この場合は、コマンド ラインからライセンス コンパイラを使用して手動でライセンスをコンパイルし、対応するアーキテクチャを指定します。 + + このツールは、Visual Studio と共に自動的にインストールされます。 このツールを実行するには、開発者コマンド プロンプト (または、Windows 7 の Visual Studio コマンド プロンプト) を使用します。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。 + + コマンド プロンプトに次のように入力します。 + +## 構文 + +``` + lc /target: + targetPE /complist:filename [/outdir:path] +/i:modules [/nologo] [/v] +``` + +|オプション|説明| +|------------|-----------------| +|**/complist:** *filename*|.licenses ファイルに組み込むライセンス付きコンポーネントの一覧を含むファイルの名前を指定します。 各コンポーネントを参照するにはフルネームを使用し、各行にコンポーネントを 1 つだけ指定します。

コマンド行を使用する場合は、プロジェクトに属するフォームごとに個別のファイルを指定できます。 Lc.exe は複数の入力ファイルを受け付けて、1 つの .licenses ファイルを生成します。| +|**/h**[**elp**]|このツールのコマンド構文とオプションを表示します。| +|**/i:** *module*|**/complist** ファイル内に一覧表示されたコンポーネントを含むモジュールを指定します。 複数のモジュールを指定するには、複数の **/i** フラグを使用します。| +|**/nologo**|Microsoft 著作権情報を表示しません。| +|**/outdir:** *path*|出力 .licenses ファイルを格納するディレクトリを指定します。| +|**/target:** *targetPE*|.licenses ファイルを生成する実行可能ファイルを指定します。| +|**/v**|詳細出力モードを指定します。コンパイルの進行状況に関する情報が表示されます。| +|**@** *file*|応答 (.rsp) ファイルを指定します。| +|**/?**|このツールのコマンド構文とオプションを表示します。| + +## 例 + +1. `HostApp.exe` という名前のアプリケーション内の `Samples.DLL` に格納されているライセンス付きコントロール `MyCompany.Samples.LicControl1` を使用すると*、*次の内容を含む `HostAppLic.txt` を作成できます。 + + ``` + MyCompany.Samples.LicControl1, Samples.DLL + ``` + +2. `HostApp.exe.licenses` という名前の .licenses ファイルを次のコマンドで作成します。 + + ``` + lc /target:HostApp.exe /complist:hostapplic.txt /i:Samples.DLL /outdir:c:\bindir + ``` + +3. この .licenses ファイルをリソースとして含む `HostApp.exe` を作成します。 C# アプリケーションを作成していた場合は、次のコマンドを使用してアプリケーションを作成します。 + + ``` + csc /res:HostApp.exe.licenses /out:HostApp.exe *.cs + ``` + + `myApp.licenses`、`hostapplic.txt`、および `hostapplic2.txt` で指定されるライセンス付きコンポーネントの一覧から `hostapplic3.txt` をコンパイルするコマンドを次に示します。 引数 `modulesList` によって、ライセンス付きコンポーネントを含むモジュールを指定します。 + +``` +lc /target:myApp /complist:hostapplic.txt /complist:hostapplic2.txt /complist: hostapplic3.txt /i:modulesList +``` + +## 応答ファイルの例 + 次のリストは、`response.rsp` 応答ファイルの例を示しています。 応答ファイルの詳細については、「[応答ファイル](/visualstudio/msbuild/msbuild-response-files)」をご覧ください。 + +``` +/target:hostapp.exe +/complist:hostapplic.txt +/i:WFCPrj.dll +/outdir:"C:\My Folder" +``` + + 次のコマンドラインで、この `response.rsp` ファイルを使用します。 + +``` +lc @response.rsp +``` + +## 関連項目 + [ツール](../../../docs/framework/tools/index.md) + [Al.exe (アセンブリ リンカー)](../../../docs/framework/tools/al-exe-assembly-linker.md) + [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md) + diff --git a/docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md b/docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md new file mode 100644 index 00000000000..3c8d6982567 --- /dev/null +++ b/docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md @@ -0,0 +1,217 @@ +--- +title: "Mage.exe (マニフェストの生成および編集ツール) | Microsoft ドキュメント" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-clr +ms.tgt_pltfrm: +ms.topic: article +dev_langs: +- VB +- CSharp +- C++ +- jsharp +helpviewer_keywords: +- Manifest Generation and Editing tool +- Mage.exe +ms.assetid: 77dfe576-2962-407e-af13-82255df725a1 +caps.latest.revision: 68 +author: dotnet-bot +ms.author: dotnetcontent +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: a32f50ce8a92fa22d9627a1510a4b3ec1087364e +ms.openlocfilehash: caa06be840f0612e94742e7ea167f02b8b8d657d +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# Mage.exe (マニフェストの生成および編集ツール) +マニフェストの生成および編集ツール (Mage.exe) は、アプリケーション マニフェストおよび配置マニフェストの作成と編集をサポートするコマンド ライン ツールです。 コマンド ライン ツールであるため、Mage.exe は、バッチ スクリプトから実行することも、 [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] アプリケーションなど他の Windows ベースのアプリケーションから実行することもできます。 + + Mage.exe の代わりに、グラフィカルなアプリケーション プログラムである MageUI.exe を使用することもできます。 詳細については、「 [MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)」を参照してください。 + + このツールは、Visual Studio と共に自動的にインストールされます。 このツールを実行するには、開発者コマンド プロンプト (または、Windows 7 の Visual Studio コマンド プロンプト) を使用します。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。 + + [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] セットアップには、2 つのバージョンの Mage.exe および MageUI.exe がコンポーネントとして含まれています。 バージョン情報を確認するには、MageUI.exe を実行し、 **[ヘルプ]**をクリックして、 **[バージョン情報]**をクリックします。 このドキュメントでは、バージョン 4.0.x.x の Mage.exe および MageUI.exe について説明します。 + + コマンド プロンプトに次のように入力します。 + +## 構文 + +``` +Mage [commands] [commandOptions] +``` + +#### パラメーター + 次の表に、Mage.exe でサポートされているコマンドを示します。 これらのコマンドでサポートされるオプションの詳細については、「 [New コマンド オプションと Update コマンド オプション](#NewUpdate) 」および「 [Sign コマンド オプション](#Sign)」を参照してください。 + +|コマンド|説明| +|-------------|-----------------| +|**-cc, ClearApplicationCache**|すべてのオンライン専用アプリケーションのダウンロード アプリケーション キャッシュをクリアします。| +|**-n, -New** *fileType [newOptions]*|指定された種類のファイルを新規作成します。 有効な種類は、次のとおりです。

- `Deployment` : 配置マニフェストを新規作成します。
- `Application` : アプリケーション マニフェストを新規作成します。

このコマンドで他のパラメーターを指定しなかった場合は、適切な既定のタグおよび属性値を使用して、適切な種類のファイルが作成されます。

**-ToFile** オプション (次の表を参照) を使用して、新しいファイルの名前とパスを指定します。

マニフェストの \ セクションに追加されたアプリケーション用のすべてのアセンブリを使用して、アプリケーション マニフェストを作成する場合は、**-FromDirectory** オプション (次の表を参照) を使用します。| +|**-u, -Update** *[filePath] [updateOptions]*|1 つ以上の変更をマニフェスト ファイルに加えます。 編集中のファイルの種類を指定する必要はありません。 Mage.exe は、一連のヒューリスティックを使用してファイルを調査し、配置マニフェストであるのか、アプリケーション マニフェストであるのかを判定します。

ファイルが証明書で署名済みの場合に **-Update** を指定すると、キー署名ブロックが削除されます。 これは、キー署名にはファイルのハッシュが含まれているため、ファイルを変更するとハッシュが無効になるためです。

**-ToFile** オプション (次の表を参照) を使用して、既存のテキストに上書きするのではなく、新しいファイルの名前とパスを指定します。| +|**-s, -Sign** `[signOptions]`|キー ペアまたは X509 証明書を使用してファイルに署名します。 署名は、XML 要素としてファイルに挿入されます。

**-TimestampUri** 値を指定するマニフェストに署名するときには、インターネットに接続している必要があります。| +|**-h, -?, -Help** *[verbose]*|使用可能なすべてのコマンドおよびそのオプションの説明が表示されます。 `verbose` を指定して、詳細なヘルプを表示します。| + + +## New コマンド オプションと Update コマンド オプション + 次の表は、 `-New` コマンドおよび `-Update` コマンドでサポートされているオプションを示しています。 + +|オプション|既定値|対象|説明| +|-------------|-------------------|----------------|-----------------| +|**-a, -Algorithm**|sha1RSA|アプリケーション マニフェスト

配置マニフェスト|アルゴリズムの依存関係のダイジェストを生成するように指定します。 値は、"sha256RSA" または "sha1RSA" であることが必要です。

"-Update" オプションでのみ使用します。 "-Sign" オプションを使用した場合、このオプションは無視されます| +|**-appc, -AppCodeBase** `manifestReference`||配置マニフェスト|アプリケーション マニフェスト ファイルへの URL またはファイル パス参照を挿入します。 この値は、アプリケーション マニフェストへの完全パスである必要があります。| +|**-appm, -AppManifest** `manifestPath`||配置マニフェスト|配置のアプリケーション マニフェストへの参照を、その配置マニフェストに挿入します。

`manifestPath` に指定したファイルは存在する必要があります。存在しない場合、Mage.exe はエラーを発行します。 `manifestPath` の参照先のファイルがアプリケーション マニフェストでない場合、Mage.exe はエラーを発行します。| +|**-cf, -CertFile** `filePath`||すべてのファイルの種類|マニフェストに署名するための X509 デジタル証明書の場所を指定します。 証明書にパスワードが必要な場合は、このオプションを **-Password** オプションと共に使用できます。| +|**-ch, -CertHash** `hashSignature`||すべてのファイルの種類|クライアント コンピューターの個人証明書ストアに格納されているデジタル証明書のハッシュです。 これは、Windows の証明書コンソールに表示されるデジタル証明書のサムプリント文字列に対応しています。

`hashSignature` には、大文字も小文字も使用できます。また、1 つの文字列で指定することも、サムプリント文字の各オクテット (8 ビット) を空白で区切り、サムプリント全体を引用符で囲んで指定することもできます。| +|**-fd, -FromDirectory** `directoryPath`||アプリケーション マニフェスト|`directoryPath`およびそのすべてのサブディレクトリで見つかったすべてのアセンブリとファイルの説明を含んでいるアプリケーション マニフェストを作成します。ここで、 `directoryPath` は、配置対象のアプリケーションが格納されているディレクトリです。 Mage.exe では、ディレクトリ内のファイルごとに、そのファイルがアセンブリなのかスタティック ファイルなのかが判断されます。 アセンブリの場合は、 `` タグおよび `installFrom` 属性が、アセンブリ名、コード ベースおよびバージョンと共に、アプリケーションに追加されます。 スタティック ファイルの場合は、 `` タグが追加されます。 また、Mage.exe は、簡単な一連のヒューリスティックによってアプリケーションのメイン実行可能モジュールを検出し、この実行可能モジュールを ClickOnce アプリケーションのエントリ ポイントとしてマニフェストでマークします。

Mage.exe では、ファイルが "データ" ファイルとして自動的にマークされることはありません。 これは手動で行う必要があります。 詳細については、「 [How to: Include a Data File in a ClickOnce Application](/visualstudio/deployment/how-to-include-a-data-file-in-a-clickonce-application)」を参照してください。

Mage.exe では、各ファイルのサイズに基づいて、各ファイルのハッシュも生成されます。 ClickOnce では、マニフェスト作成後に、配置の各ファイルが改ざんされていないことを確認するためにこれらのハッシュを使用します。 配置対象のファイルに変更を加えた場合には、Mage.exe を **-Update** コマンドおよび **-FromDirectory** オプションを付けて実行すると、参照している全ファイルのハッシュおよびアセンブリ バージョンを更新できます。

**-FromDirectory** を指定すると、 `directoryPath`で見つかった全サブディレクトリの全ファイルが含まれます。

**-FromDirectory** を **-Update** コマンドと共に使用すると、アプリケーション マニフェスト内のファイルのうち、このディレクトリに存在しなくなったファイルが Mage.exe によってマニフェストから削除されます。| +|**-if, -IconFile** `filePath`||アプリケーション マニフェスト|.ICO アイコン ファイルの完全パスを指定します。 このアイコンは、[スタート] メニューおよび [プログラムの追加と削除] エントリのアプリケーション名の横に表示されます。 アイコンを指定しない場合は、既定のアイコンが使用されます。| +|**-ip, -IncludeProviderURL** `url`|true|配置マニフェスト|**-ProviderURL**で設定された更新プログラムの場所の値が配置マニフェストに含まれているかどうかを示します。| +|**-i, -Install** `willInstall`|true|配置マニフェスト|ClickOnce アプリケーションをローカル コンピューターにインストールするのか、Web サイトで実行するのかを指定します。 アプリケーションをインストールすると、アプリケーションは Windows の **[スタート]** メニューに表示されます。 有効な値は、"true" または "t"、および "false" または "f" です。

**-MinVersion** オプションを指定し、ユーザーが **-MinVersion** より前のバージョンをインストールしていた場合は、 **-Install**に渡した値に関係なく、アプリケーションがインストールされます。

このオプションは、 **-BrowserHosted** オプションと一緒に使用することはできません。 1 つのマニフェストに両方のオプションを使用しようとすると、エラーが発生します。| +|**-mv, -MinVersion** `[version]`|**-Version** フラグで指定された、ClickOnce 配置マニフェストに示されたバージョン。|配置マニフェスト|ユーザーが実行できる、このアプリケーションの最小バージョンです。 このフラグで指定したバージョンが、アプリケーションの最低限必要なバージョンになります。 大幅に変更された更新プログラムを含むバージョンや、重大なセキュリティ問題を解決したバージョンの製品をリリースした場合に、このフラグを使用すると、この更新バージョンを必ずインストールするように指定でき、ユーザーは古いバージョンを実行できなくなります。

`version` は、 **-Version** フラグの引数と同じ意味を持ちます。| +|**-n, -Name** `nameString`|配置|すべてのファイルの種類|アプリケーションを識別するための名前です。 ClickOnce では、**[スタート]** メニュー (アプリケーションをインストールする場合) やアクセス許可の昇格のダイアログ ボックスでこのアプリケーションを示す名前として、この名前が使用されます。 **メモ:** 既存のマニフェストを更新するときにこのオプションで発行者名を指定しない場合、Mage.exe はコンピューターで定義された組織名でマニフェストを更新します。 別の名前を使用するには、必ずこのオプションを使用して希望する発行者名を指定してください。| +|**-pwd, -Password** `passwd`||すべてのファイルの種類|デジタル証明書でマニフェストに署名する場合に使用するパスワードです。 **-CertFile** オプションと共に使用する必要があります。| +|**-p, Processor** `processorValue`|Msil|アプリケーション マニフェスト

配置マニフェスト|このアプリケーションを実行するマイクロプロセッサのアーキテクチャです。 特定のマイクロプロセッサ用にアセンブリがプリコンパイルされている、1 つ以上のアプリケーションを配置する場合は、この値を指定する必要があります。 有効な値には、 `msil`、 `x86`、 `ia64`、および `amd64`があります。 `msil` (Microsoft Intermediate Language) は、すべてのアセンブリがどのプラットフォームにも依存していないことを示します。この場合、共通言語ランタイム (CLR: Common Language Runtime) は、アプリケーションの最初の実行時にアセンブリの Just-In-Time コンパイルを行います。| +|**-pu,** **-ProviderURL** `url`||配置マニフェスト|ClickOnce でアプリケーションの更新プログラムのチェックを行う場合に参照する URL を指定します。| +|**-pub, -Publisher** `publisherName`||アプリケーション マニフェスト

配置マニフェスト|配置マニフェストとアプリケーション マニフェストのいずれかの description 要素に発行者名を追加します。 アプリケーション マニフェストで使用する場合、 **-UseManifestForTrust** も指定する必要があります (値は "true" または "t" に設定します)。指定しないと、エラーが発生します。| +|**-s, -SupportURL** `url`||アプリケーション マニフェスト

配置マニフェスト|[プログラムの追加と削除] で、ClickOnce アプリケーションのエントリに表示されるリンクを指定します。| +|**-ti, -TimestampUri** `uri`||アプリケーション マニフェスト

配置マニフェスト|デジタル タイムスタンプ サービスの URL です。 マニフェストにタイムスタンプを設定すると、マニフェストに再署名することを防止できますが、アプリケーションの次のバージョンを配置する前にデジタル証明書の有効期限が切れるようにする必要があります。 詳細については、 [Windows ルート証明書プログラムのメンバー](http://go.microsoft.com/fwlink/?LinkId=159000)を参照してください。| +|**-t, -ToFile** `filePath`|- New:
- 配置マニフェストの場合: deploy.application
- アプリケーション マニフェストの場合: application.exe.manifest
- Update コマンド オプション:
- 入力ファイル|すべてのファイルの種類|作成または変更されたファイルの出力パスを指定します。

**-New** を使用するときに **-ToFile**を指定しなかった場合、出力ファイルは現在の作業ディレクトリに書き込まれます。 **-Update** を使用する場合に **-ToFile**を指定しなかった場合、Mage.exe では、入力ファイルにファイルが書き戻されます。| +|**-tr, -TrustLevel** `level`|アプリケーション URL が存在するゾーンに基づいて。|アプリケーション マニフェスト|クライアント コンピューター上のアプリケーションに与える信頼のレベルです。 有効な値には、"Internet"、"Intranet"、および "FullTrust" が含まれます。| +|**-um, -UseManifestForTrust** `willUseForTrust`|False|アプリケーション マニフェスト|アプリケーションをクライアントで実行するときに、アプリケーション マニフェストのデジタル署名を信頼の決定に使用するかどうかを指定します。 "true" または "t" を指定すると、信頼の決定にアプリケーション マニフェストが使用されます。 "false" または "f" を指定すると、信頼の決定に配置マニフェストの署名が使用されます。| +|**-v, -Version** `versionNumber`|1.0.0.0|アプリケーション マニフェスト

配置マニフェスト|配置のバージョンです。 引数は "*N.N.N.N*" という形式の有効なバージョン文字列である必要があります。ここで "*N*" は、32 ビット符号なし整数です。| +|**-wpf, -WPFBrowserApp** `isWPFApp`|False|アプリケーション マニフェスト

配置マニフェスト|このフラグは、アプリケーションが Internet Explorer の内部でホストされ、スタンドアロンの実行可能ファイルではない Windows Presentation Foundation (WPF) アプリケーションである場合にのみ使用します。 有効な値は、"true" または "t"、および "false" または "f" です。

アプリケーション マニフェストの場合、そのアプリケーション マニフェストの `hostInBrowser` 要素に `entryPoint` 属性を追加します。

配置マニフェストの場合、 `install` 要素の `deployment` 属性に false を設定し、.xbap 拡張子を指定して配置マニフェストを保存します。 この引数を **-Install** 引数と共に指定すると、ブラウザーによってホストされるアプリケーションをインストールできず、アプリケーションがオフラインになるため、エラーが発生します。| + + +## Sign コマンド オプション + 次の表は、 `-Sign` コマンドでサポートされているオプションを示しています。このコマンドは、すべての種類のファイルに適用されます。 + +|オプション|説明| +|-------------|-----------------| +|**-cf, -CertFile** `filePath`|マニフェストに署名するための証明書の場所を指定します。 このオプションは **-Password** オプションと共に使用できます。| +|**-ch, -CertHash** `hashSignature`|クライアント コンピューターの個人証明書ストアに格納されているデジタル証明書のハッシュです。 これは、Windows の証明書コンソールに表示されるデジタル証明書の拇印プロパティに対応しています。

`hashSignature` には、大文字も小文字も使用できます。また、1 つの文字列で指定することも、サムプリント文字の各オクテット (8 ビット) を空白で区切り、サムプリント全体を引用符で囲んで指定することもできます。| +|**-pwd, -Password** `passwd`|デジタル証明書でマニフェストに署名する場合に使用するパスワードです。 **-CertFile** オプションと共に使用する必要があります。| +|**-t, -ToFile** `filePath`|作成または変更されたファイルの出力パスを指定します。| + +## コメント + Mage.exe では、どの引数も大文字と小文字が区別されません。 コマンドおよびオプションの前には、ダッシュ (-) またはスラッシュ (/) を付けることができます。 + + **-Sign** コマンドと共に使用できる引数は、すべて、 **-New** コマンドまたは **-Update** コマンドでも、常に使用できます。 次のコマンドは同等です。 + +``` +mage -Sign c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx +mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx +``` + +> [!NOTE] +> .NET framework version 4.6.2 以降では、CNG 証明書もサポートされます。 + + 署名済みのファイルでは、文書のシグネチャが有効であるかどうかがファイルのハッシュによって確認されるため、署名は最後に行う必要があります。 署名済みのファイルに変更を加えた場合には、再度署名する必要があります。 署名済みの文書に再度署名した場合、Mage.exe では、古い署名が新しい署名で置換されます。 + + **-AppManifest** オプションを使用して配置マニフェストを作成した場合、Mage.exe は、配置マニフェストと同じディレクトリにアプリケーション マニフェストが存在し、サブディレクトリには現在の配置のバージョンから名前が付けてあると仮定して、配置マニフェストを適切に構成します。 アプリケーション マニフェストを別の場所に格納する場合は、 **-AppCodeBase** オプションを使用して、他の場所を設定します。 + + 配置マニフェストおよびアプリケーション マニフェストは、アプリケーションを配置する前に、署名される必要があります。 マニフェストに署名する方法については、「[信頼されたアプリケーションの配置の概要](/visualstudio/deployment/trusted-application-deployment-overview)」を参照してください。 + + アプリケーション マニフェストに **-TrustLevel** オプションを指定すると、アプリケーションをクライアント コンピューターで実行するために必要なアクセス許可セットが表示されます。 既定では、アプリケーションの URL が存在する *ゾーン* に基づいてアプリケーションに信頼レベルが割り当てられます。 会社のネットワーク上にアプリケーションを配置する場合、アプリケーションは通常、イントラネット ゾーンに格納されます。一方、インターネット上にアプリケーションを配置する場合には、インターネット ゾーンに格納されます。 どちらのセキュリティ ゾーンでも、アプリケーションからローカル リソースへのアクセスは制限されますが、イントラネット ゾーンはインターネット ゾーンに比べ、制限が少し緩くなっています。 FullTrust ゾーンのアプリケーションの場合には、コンピューターのローカル リソースに制限なしでアクセスできます。 **-TrustLevel** オプションを使用してアプリケーションのゾーンを指定すると、高いレベルの信頼を与えるかどうかを決定するように求めるメッセージが、CLR の Trust Manager コンポーネントによってユーザーに表示されます。 会社のネットワーク上にアプリケーションを配置する場合は、信頼されたアプリケーションの配置を使用すると、ユーザーにメッセージで確認することなく、アプリケーションの信頼レベルを引き上げることができます。 + + アプリケーション マニフェストでは、カスタム信頼セクションもサポートされています。 この機能では、アプリケーションの実行に必要な特定のアクセス許可だけを要求するマニフェストを構成できるため、最低限のアクセス許可を要求するセキュリティ プリンシパルにアプリケーションを従わせることができます。 Mage.exe では、カスタム信頼セクションの追加は直接サポートされていません。 これを追加するには、テキスト エディター、XML パーサー、またはグラフィカルなツールである MageUI.exe を使用してください。 MageUI.exe を使用してカスタム信頼セクションを追加する方法の詳細については、「 [MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)」を参照してください。 + + [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)]に含まれているバージョン 4 の Mage.exe で作成される新しいマニフェストは、 [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)]を対象とします。 旧バージョンの .NET Framework を対象にするには、旧バージョンの Mage.exe を使用する必要があります。 既存のマニフェストに対してアセンブリの追加または削除を実行しても、既存のマニフェストに再署名しても、Mage.exe は [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)]を対象にするようにマニフェストを更新しません。 これらの機能および制限事項を次の表に示します。 + +|マニフェストのバージョン|操作|Mage v2.0|Mage v4.0| +|----------------------|---------------|---------------|---------------| +|.NET Framework 2.0 または 3.x を対象とするアプリケーションのマニフェスト|開く|OK|OK| +||閉じる|OK|OK| +||保存|OK|OK| +||再署名|OK|OK| +||新規作成|OK|サポートなし| +||更新 (以下を参照)|OK|OK| +|.NET Framework 4 を対象とするアプリケーションのマニフェスト|開く|OK|OK| +||閉じる|OK|OK| +||保存|OK|OK| +||再署名|OK|OK| +||新規作成|サポートなし|OK| +||更新 (以下を参照)|サポートなし|OK| + +|マニフェストのバージョン|更新操作の詳細|Mage v2.0|Mage v4.0| +|----------------------|------------------------------|---------------|---------------| +|.NET Framework 2.0 または 3.x を対象とするアプリケーションのマニフェスト|アセンブリの変更|OK|OK| +||アセンブリの追加|OK|OK| +||アセンブリの削除|OK|OK| +|.NET Framework 4 を対象とするアプリケーションのマニフェスト|アセンブリの変更|サポートなし|OK| +||アセンブリの追加|サポートなし|OK| +||アセンブリの削除|サポートなし|OK| + + Mage.exe は、 [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)]を対象とする新しいマニフェストを作成します。 [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象とする ClickOnce アプリケーションは、 [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] と完全版の [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)]の両方で実行できます。 アプリケーションが完全版の [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を対象としていて、 [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)]で実行できない場合は、テキスト エディターを使用してクライアントの `` 要素を削除し、マニフェストに再署名します。 `` を対象とする [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)]要素の例を次に示します。 + +```xml + +``` + +## 例 + Mage 用のユーザー インターフェイス (MageUI.exe) を開く例を次に示します。 + +``` +mage +``` + + 既定の配置マニフェストおよびアプリケーション マニフェストを作成する例を次に示します。 これらのファイルは、すべて現在の作業ディレクトリに作成され、それぞれ deploy.application と application.exe.manifest という名前が付けられます。 + +``` +mage -New Deployment +mage -New Application +``` + + 現在のディレクトリにあるすべてのアセンブリとすべてのリソース ファイルを含めたアプリケーション マニフェストを作成する例を次に示します。 + +``` +mage -New Application -FromDirectory . -Version 1.0.0.0 +``` + + 次の例は、前の例に続いて、配置名および対象のマイクロプロセッサを指定します。 ここでは、ClickOnce が更新プログラムを確認する対象の URL も指定します。 + +``` +mage -New Application -FromDirectory . -Name "Hello, World! Application" -Version 1.0.0.0 -Processor "x86" -ProviderUrl http://internalserver/HelloWorld/ +``` + + Internet Explorer でホストされる WPF アプリケーションを配置するための一組のマニフェストを作成する方法を次の例に示します。 + +``` +mage -New Application -FromDirectory . -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 +``` + +## 関連項目 + [ClickOnce のセキュリティと配置](/visualstudio/deployment/clickonce-security-and-deployment) + [チュートリアル : ClickOnce アプリケーションを手動で配置する](/visualstudio/deployment/walkthrough-manually-deploying-a-clickonce-application) + [信頼されたアプリケーションの配置の概要](/visualstudio/deployment/trusted-application-deployment-overview) + [MageUI.exe (マニフェスト生成および編集ツールのグラフィカル クライアント)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md) + [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md) diff --git a/docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md b/docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md new file mode 100644 index 00000000000..e46cfff7879 --- /dev/null +++ b/docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md @@ -0,0 +1,212 @@ +--- +title: "MageUI.exe (マニフェスト生成および編集ツールのグラフィカル クライアント) | Microsoft Docs" +ms.custom: +ms.date: 03/30/2017 +ms.prod: .net-framework +ms.reviewer: +ms.suite: +ms.technology: +- dotnet-clr +ms.tgt_pltfrm: +ms.topic: article +dev_langs: +- VB +- CSharp +- C++ +- jsharp +helpviewer_keywords: +- Manifest Generation and Editing tool +- MageUI.exe +ms.assetid: f9e130a6-8117-49c4-839c-c988f641dc14 +caps.latest.revision: 38 +author: dotnet-bot +ms.author: dotnetcontent +manager: wpickett +ms.translationtype: Machine Translation +ms.sourcegitcommit: fe32676f0e39ed109a68f39584cf41aec5f5ce90 +ms.openlocfilehash: acd994c4b36200a924c537750f7e8b14a24d06c8 +ms.contentlocale: ja-jp +ms.lasthandoff: 06/02/2017 + +--- +# MageUI.exe (マニフェスト生成および編集ツールのグラフィカル クライアント) +MageUI.exe でサポートされている機能は、コマンド ライン ツール Mage.exe の機能と同じですが、MageUI.exe には、Windows ベースのユーザー インターフェイス (UI) があります。 このツールを使用すると、配置マニフェストおよびアプリケーション マニフェストを作成および編集でき、これらのマニフェストに署名することができます。 MageUI.exe で作成される新しいマニフェストは、[!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象とします。 以前のバージョンの .NET Framework を対象にするには、以前のバージョンの MageUI.exe を使用する必要があります。 マニフェストに対してアセンブリの追加または削除を実行しても、既存のマニフェストに再署名しても、MageUI.exe は [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象にするようにマニフェストを更新しません。 詳しくは、「[Mage.exe (マニフェストの生成および編集ツール)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md)」をご覧ください。 + + このツールは、Visual Studio と共に自動的にインストールされます。 このツールを実行するには、開発者コマンド プロンプト (または、Windows 7 の Visual Studio コマンド プロンプト) を使用します。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。 + + [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] セットアップには、2 つのバージョンの Mage.exe および MageUI.exe がコンポーネントとして含まれています。 バージョン情報を確認するには、MageUI.exe を実行し、 **[ヘルプ]**をクリックして、 **[バージョン情報]**をクリックします。 このドキュメントでは、バージョン 4.0.x.x の Mage.exe および MageUI.exe について説明します。 + +> [!NOTE] +> MageUI.exe は、MageUI.exe を使用して証明書で署名済みのアプリケーション マニフェストを保存する場合、[compatibleFrameworks](/visualstudio/deployment/compatibleframeworks-element-clickonce-deployment) 要素をサポートしません。 代わりに [Mage.exe](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md) を使用する必要があります。 + +## UIElement の一覧 + 次の表に、利用できるメニューおよびツール バー項目の一覧を表示します。 + +|コマンド|メニュー|ショートカット|説明| +|-------------|----------|--------------|-----------------| +|**アプリケーション マニフェスト**|**[ファイル] > [新規]**||アプリケーション マニフェストを新規作成します。| +|**配置マニフェスト**|**[ファイル] > [新規]**||配置マニフェストを新規作成します。| +|**開く**|**ファイル**|Ctrl + O|既存の配置マニフェスト、アプリケーション マニフェストまたは信用ライセンスを編集用に開きます。| +|**閉じる**|**ファイル**|Ctrl + F4|開いているファイルを閉じます。

閉じるファイルが変更されていた場合は、公開キー、キー ペア、または格納済みの証明書を使ってファイルに再度署名することを求めるメッセージが表示されます。| +|**保存**|**ファイル**|Ctrl + S|ユーザー入力のフォーカスがある文書をディスクに保存します。| +|**名前を付けて保存**|**ファイル**||ファイルをディスクに保存します。この場合、ユーザーは新しいファイル名や場所を指定できます。| +|**すべてを保存**|**ファイル**||MageUI.exe 内で現在開かれている各ファイルに対して行った変更を保存します。| +|**ユーザー設定**|**ファイル**||**[ユーザー設定]** ダイアログ ボックスを開きます。 詳細については、以下のセクションを参照してください。| +|**終了**|**ファイル**|Alt + F4|MageUI.exe を終了します。| +|**切り取り**|**編集**|Ctrl + X|現在選択されているテキストをアプリケーションから削除し、システムのクリップボードに移動します。| +|**コピー**|**編集**|Ctrl + C|現在選択されているテキストを、システムのクリップボードにコピーします。| +|**貼り付け**|**編集**|Ctrl + V|システム クリップボードから現在アクティブなテキスト要素にテキストを貼り付けます。| +|**削除**|**編集**||現在選択されている一覧、たとえば **[配置マニフェスト]** タブの信用ライセンスなどで現在選択されている要素を削除します。| +|**すべて閉じる**|**ウィンドウ**||現在 MageUI.exe で開かれているすべてのファイルを閉じます。 保存する必要のあるファイルが存在する場合は、それらのファイルを保存するように要求するメッセージが表示されます。 また、未署名のファイルや変更されたファイルについては、署名キーを選択するように示すメッセージもファイルごとに表示されます。| +|**バージョン情報**|**ヘルプ**||MageUI.exe のバージョンおよび著作権についての情報が表示されます。| + +## [ユーザー設定] ダイアログ ボックス + **[ユーザー設定]** ダイアログ ボックスには、以下の項目があります。 + +|UI 要素|説明| +|----------------|-----------------| +|**保存時に署名する**|変更内容を保存するたびに、ファイルへの署名を促すメッセージが表示されます。| +|**既定の署名用証明書を使用する**|どのファイルに署名する場合でも **[証明書ファイル]** ボックスに入力されたキーを使用します。 こうすると、**[保存時に署名する]** チェック ボックスをオンにした状態でファイルを保存した場合などに表示される、署名を要求するメッセージが表示されなくなります。 キー ファイルを選択するには、**[証明書ファイル]** ボックスの横の省略記号 (**...**) ボタンをクリックします。| +|ダイジェスト アルゴリズム|アルゴリズムの依存関係のダイジェストを生成するように指定します。 値は、"sha256RSA" または "sha1RSA" であることが必要です。 既定として SHA1 を使用します。 アプリケーション マニフェストと配置マニフェストの両方に署名します。 ユーザーがマニフェストの保存時に証明書を提供した場合、依存関係ダイジェストを生成するために証明書内のアルゴリズムを使用します。| + +## [署名オプション] ダイアログ ボックス + **[署名オプション]** ダイアログ ボックスは、マニフェストや信用ライセンスを初めて保存する場合、またはマニフェストや信用ライセンスを変更する場合に表示されます。 **[ユーザー設定]** ダイアログ ボックスの **[保存時に署名する]** チェック ボックスがオンの場合にだけ表示されます。 **[タイムスタンプ URI]** ボックスの値を指定するマニフェストに署名するときには、インターネットに接続している必要があります。 + + このダイアログ ボックスには、以下の項目があります。 + +|UI 要素|説明| +|----------------|-----------------| +|**証明書ファイルで署名する**|ファイル システムに格納されているデジタル証明書でマニフェストに署名します。| +|**ファイル**|証明書を表す .pfx ファイルのパスの入力欄です。| +|**...**|既存の .pfx ファイルを選択するための **[ファイルの選択]** ダイアログ ボックスを開きます。| +|**新規**|証明機関 (CA: Certificate Authority) によって証明できない、.pfx ファイルを新規作成します。 [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] の配置に署名するために使用する証明書の種類の詳細については、「[信頼されたアプリケーションの配置の概要](/visualstudio/deployment/trusted-application-deployment-overview)」を参照してください。| +|**パスワード**|この証明書で署名するために使用するパスワードの入力欄です。 該当しない場合は、空白にできます。| +|**保存された証明書で署名する**|使用しているコンピューターの証明書ストアに格納されている、選択可能なデジタル署名が一覧表示されます。| +|**タイムスタンプ URI**|デジタル タイムスタンプ サービスの URI (Uniform Resource Locator) が表示されます。 次のバージョンのアプリケーションを配置する前にデジタル証明書の有効期限が切れる場合、マニフェストにタイムスタンプを設定すると、マニフェストに再署名する必要がなくなります。 詳細については、[Windows ルート証明書プログラムのメンバー](http://go.microsoft.com/fwlink/?LinkId=159000)に関するページと「[ClickOnce and Authenticode](/visualstudio/deployment/clickonce-and-authenticode)」 (ClickOnce と Authenticode)を参照してください。| +|**署名しない**|デジタル証明書から署名を追加せずにマニフェストを保存できます。| + +## タブおよびパネルの説明 + MageUI.exe で文書を開くと、その文書用のタブ ページに文書が表示されます。 各タブには、一連のプロパティ パネルがあります。 パネルには、文書のデータをグループ化したサブセットが表示されています。 + +### [アプリケーション マニフェスト] タブ + **[アプリケーション マニフェスト]** タブには、アプリケーション マニフェストの内容が表示されます。 アプリケーション マニフェストには、配置に含まれるすべてのファイル、およびクライアントでアプリケーションを実行するために必要なアクセス許可が記述されています。 + + **[アプリケーション マニフェスト]** タブには、次のタブが含まれます。 + +|UI 要素|説明| +|----------------|-----------------| +|**名前**|この配置に関する識別情報を指定します。| +|**説明**|発行者、製品、およびサポート情報を指定します。| +|**アプリケーション オプション**|これがブラウザー アプリケーションであるかどうか、このマニフェストが信頼情報のソースであるかどうかを指定します。| +|**ファイル**|この配置を構成するすべてのファイルを指定します。| +|**必要なアクセス許可**|アプリケーションをクライアント上で実行するために必要な、最小のアクセス許可セットを指定します。| + +### [名前] タブ + **[名前]** タブは、アプリケーション マニフェストを初めて作成するか開いたときに表示されます。 このタブでは、配置を一意に識別するほか、オプションで有効な対象プラットフォームを指定できます。 + +|UI 要素|説明| +|----------------|-----------------| +|**名前**|必須です。 アプリケーション マニフェストの名前です。 通常、ファイル名と同じです。| +|**Version**|必須です。 *N.N.N.N* という形式の配置バージョン番号です。 先頭のメジャー ビルド番号だけが必須です。 たとえば、アプリケーションのバージョンが 1.0 の場合、有効な値は、`1``1.0`、`1.0.0`、および `1.0.0.0` です。| +|**プロセッサ**|省略可能です。 この配置を実行できるコンピューターのアーキテクチャです。 既定値は `msil` (Microsoft Intermediate Language) です。これは、すべてのマネージ アセンブリでの既定の形式です。 アプリケーションのアセンブリを特定のアーキテクチャ用にプリコンパイルした場合は、このフィールドを変更します。 プリコンパイルの詳細については、「[Ngen.exe (ネイティブ イメージ ジェネレーター)](../../../docs/framework/tools/ngen-exe-native-image-generator.md)」を参照してください。| +|**カルチャ**|省略可能です。 このアプリケーションが実行される国/地域を、2 つの部分で構成される ISO のコードで指定します。 既定値は、`neutral` です。| +|**公開キー トークン**|省略可能です。 このアプリケーション マニフェストが署名されたときの公開キーです。 新しいマニフェストまたは未署名のマニフェストでは、このフィールドに [`Unsigned`] と表示されます。| + +### [説明] タブ + 通常、この情報は配置マニフェスト内で指定します。 これらのフィールドは、**[アプリケーション オプション]** タブの **[信頼情報のアプリケーション マニフェストを使用する]** チェック ボックスをオンにした場合にのみ変更できます。 + +|UI 要素|説明| +|----------------|-----------------| +|**発行元**|このアプリケーションの責任を負う個人または組織の名前です。 この値は、[スタート] メニューのフォルダー名として使用されます。| +|**製品**|製品の完全な名前です。 配置マニフェストの **[配置オプション]** タブで **[アプリケーションの種類]** の **[ローカルにインストール]** を選択した場合は、**[スタート]** メニューおよび **[プログラムの追加と削除]** に、このアプリケーションを示す項目としてこの名前が表示されます。| +|**サポート URL**|このアプリケーションのヘルプおよびサポート情報をユーザーが入手できるサイトの URL です。| + +### [アプリケーション オプション] タブ + +|UI 要素|説明| +|----------------|-----------------| +|**Windows Presentation Foundation ブラウザー アプリケーション**|これが XAML ブラウザー アプリケーション (XBAP) としてブラウザーで実行される WPF アプリケーションであるかどうかを指定します。| +|**信頼情報のアプリケーション マニフェストを使用する**|このマニフェストに信頼情報を含めるかどうかを指定します。| + +### [ファイル] タブ + +|UI 要素|説明| +|----------------|-----------------| +|**アプリケーション ディレクトリ**|アプリケーションのファイルが格納されているディレクトリです。 ディレクトリを選択するには、省略記号 (**…**) ボタンをクリックします。| +|**作成**|アプリケーション ディレクトリとサブディレクトリにあるすべてのファイルをアプリケーション マニフェストに追加します。 ディレクトリ内に実行可能ファイルが 1 つしか見つからなかった場合は、このファイルがエントリ ポイントとして自動的にマークされます。エントリ ポイントは、ClickOnce アプリケーションをクライアントで起動したときに、最初に実行されます。| +|**アプリケーション ファイル**|アプリケーション内のすべてのファイルの一覧を示します。 各ファイルには、以下で説明する 3 つの編集可能な属性があります。| +|**ファイルの種類**|ファイルの種類は以下の 4 つのうちのいずれかです。

- なし。
- エントリ ポイント。 アプリケーションのプライマリ実行可能ファイルです。 エントリ ポイントとしてマークできる実行可能ファイルは 1 つだけです。
- データ ファイル。 XML ファイルなど、アプリケーションにデータを提供するためのファイルです。
- アイコン ファイル。 アプリケーション ウィンドウの隅やデスクトップに表示されるアプリケーション アイコンです。| +|**Optional**|省略可能のマークを付けたファイルは初期インストール時や更新時にはダウンロードされませんが、System.Deployment オンデマンド API を使用して実行時にダウンロードできます。 詳細については、「[チュートリアル : デザイナーを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする](/visualstudio/deployment/walkthrough-downloading-assemblies-on-demand-with-the-clickonce-deployment-api-using-the-designer)」を参照してください。| +|**グループ**|省略可能なファイル セットのラベルです。 ファイル セットにはグループ ラベルを付けることができ、オンデマンド API を使用して、1 回の API 呼び出しで一連のファイルをダウンロードできます。| + +### [必要なアクセス許可] タブ + アプリケーションに対して、既定で付与される以上のローカル コンピューターへのアクセス許可を与える必要がある場合は、**[必要なアクセス許可]** タブを使用します。 詳細については、「[ClickOnce アプリケーションの発行](/visualstudio/deployment/securing-clickonce-applications)」を参照してください。 + +|UI 要素|説明| +|----------------|-----------------| +|**アクセス許可セットの種類**|‏このアプリケーションをクライアントで実行するために必要な、最小のアクセス許可セットです。 これらのアクセス許可セットおよび必要なアクセス許可については、「[NIB: 名前付きアクセス許可セット](http://msdn.microsoft.com/en-us/08250d67-c99d-4ab0-8d2b-b0e12019f6e3)」を参照してください。| +|**詳細**|アクセス許可セットを表すために作成された、アプリケーション マニフェスト用の XML です。 アプリケーション マニフェストの XML 形式に精通している場合を除き、この XML を手動で編集しないでください。 詳細については、「[ClickOnce アプリケーション マニフェスト](/visualstudio/deployment/clickonce-application-manifest)」を参照してください。| + +### [配置マニフェスト] タブ + **[配置マニフェスト]** タブには、次のタブが含まれます。 + +|UI 要素|説明| +|----------------|-----------------| +|**名前**|この配置に関する識別情報を指定します。| +|**説明**|発行者、製品、およびサポート情報を指定します。| +|**配置オプション**|アプリケーションの種類や開始場所など、配置に関する追加情報を指定します。| +|**更新オプション**|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] がアプリケーションの更新プログラムを確認する頻度を指定します。| +|**アプリケーション参照**|この配置のアプリケーション マニフェストを指定します。| + +### [名前] タブ + **[名前]** タブは、配置マニフェストを初めて作成したり開いたりしたときに表示されます。 このタブでは、配置を一意に識別するほか、オプションで有効な対象プラットフォームを指定できます。 + +|UI 要素|説明| +|----------------|-----------------| +|**名前**|必須です。 配置マニフェストの名前です。 通常、ファイル名と同じです。| +|**Version**|必須です。 *N.N.N.N* という形式の配置バージョン番号です。 先頭のメジャー ビルド番号だけが必須です。 たとえば、アプリケーションのバージョンが 1.0 の場合、有効な値は、`1``1.0`、`1.0.0`、および `1.0.0.0` です。| +|**プロセッサ**|省略可能です。 この配置を実行できるコンピューターのアーキテクチャです。 既定値は `msil` (Microsoft Intermediate Language) です。これは、すべてのマネージ アセンブリの既定の形式です。 アプリケーションのアセンブリを特定のアーキテクチャ用にコンパイルした場合は、このフィールドを変更します。| +|**カルチャ**|省略可能です。 このアプリケーションの実行環境となる、ISO の国/地域コードです。2 つの部分で構成されています。 既定値は、`neutral` です。| +|**公開キー トークン**|省略可能です。 この配置マニフェストが署名されたときの公開キーです。 新しいマニフェストまたは未署名のマニフェストでは、このフィールドに [`Unsigned`] と表示されます。| + +### [説明] タブ + +|UI 要素|説明| +|----------------|-----------------| +|**発行元**|必須です。 このアプリケーションの責任を負う個人または組織の名前です。 この値は、[スタート] メニューのフォルダー名として使用されます。| +|**製品**|必須です。 製品の完全な名前です。 **[配置オプション]** タブで **[アプリケーションの種類]** の **[ローカルにインストール]** を選択した場合は、**[スタート]** メニューおよび **[プログラムの追加と削除]** に、このアプリケーションを示す項目としてこの名前が表示されます。| +|**サポート URL**|省略可能です。 このアプリケーションのヘルプおよびサポート情報をユーザーが入手できるサイトの URL です。| + +### [配置オプション] タブ + +|UI 要素|説明| +|----------------|-----------------| +|**アプリケーションの種類**|省略可能です。 このアプリケーションが、クライアント コンピューターにインストールされるか (**[ローカルにインストール]**)、オンラインで実行されるか (**[オンラインのみ]**)、ブラウザーで実行される WPF アプリケーションか **([WPF ブラウザー アプリケーション]**) を指定します。 既定値は **[ローカルにインストール]** です。| +|**開始位置**|省略可能です。 アプリケーションを実際に起動するサイトの URL です。 CD からアプリケーションを配置し、Web サイト経由で更新する必要がある場合に便利です。| +|**開始場所 (ProviderURL) をマニフェストに含める**|省略可能です。 [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] でアプリケーションの更新プログラムを確認する場合に参照する URL を指定します。| +|**インストール後にアプリケーションを自動的に実行する**|必須です。 URL からの最初のインストールが完了したら、すぐにアプリケーションを実行するように [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] に指定します。 既定では、チェック ボックスがオンになっています。| +|**URL パラメーターをアプリケーションに渡すことを許可する**|必須です。 配置マニフェストの URL にクエリ文字列を追加することで、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションにパラメーター データを渡すことができるようにします。 既定では、チェック ボックスがオフになっています。| +|**.deploy ファイル拡張子を使用する**|必須です。 オンにした場合、アプリケーション マニフェストのすべてのファイルの拡張子が .deploy になります。 既定では、チェック ボックスがオフになっています。| + +### [更新オプション] タブ + **[更新オプション]** タブには、**[名前]** タブの **[アプリケーションの種類]** 選択ボックスで **[ローカルにインストール]** が選択されている場合にのみ、ここで説明するオプションが表示されます。 + +|UI 要素|説明| +|----------------|-----------------| +|**このアプリケーションの更新プログラムを確認する**|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] でアプリケーションの更新プログラムを確認する必要があるかどうかを指定します。 このチェック ボックスをオフにした場合、アプリケーションの更新情報は確認されません。ただし、 名前空間の API を使用すると、プログラムによってアプリケーションを更新できます。| +|**アプリケーションの更新を確認する方法を選択してください**|更新プログラムの確認について次の 2 つのオプションがあります。

- **アプリケーションの開始前に行う**。 アプリケーションを実行する前に更新プログラムを確認します。
- **アプリケーションの開始後に行う**。 アプリケーションのメイン フォームが初期化されると更新プログラムの確認が開始され、アプリケーションが次に起動されたときに更新プログラムの確認が実行されます。| +|**更新プログラムの確認の頻度**|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] で更新プログラムを確認する頻度を指定します。

- **アプリケーションが実行するたびに確認する**。 ユーザーがアプリケーションを起動するたびに、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] によって更新プログラムが確認されます。
- **確認する間隔**: 更新プログラムを確認するまでの経過時間の間隔と単位 (時間、日、または週) を選択します。| +|**このアプリケーションに最低限必要なバージョンを指定する**|省略可能です。 アプリケーションの特定のバージョンを必須インストールとして指定し、ユーザーが旧バージョンを使用しないようにします。| +|**Version**|**[このアプリケーションに最低限必要なバージョンを指定する]** チェック ボックスをオンにした場合は必須です。 指定されたバージョン番号が *N.N.N.N* という形式である必要があります。 先頭のメジャー ビルド番号だけが必須です。 たとえば、アプリケーションのバージョンが 1.0 の場合、有効な値は、`1``1.0`、`1.0.0`、および `1.0.0.0` です。| + +### [アプリケーション参照] タブ + **[アプリケーション参照]** タブには、このトピックで既に説明した **[名前]** タブと同じフィールドがあります。 ただし、次のフィールドだけが異なります。 + +|UI 要素|説明| +|----------------|-----------------| +|**マニフェストの選択**|アプリケーション マニフェストを選択できます。 アプリケーション マニフェストを選択すると、このページの他のすべてのフィールドの値が設定されます。| + +## 関連項目 + [ClickOnce のセキュリティと配置](/visualstudio/deployment/clickonce-security-and-deployment) + [チュートリアル : ClickOnce アプリケーションを手動で配置する](/visualstudio/deployment/walkthrough-manually-deploying-a-clickonce-application) + [Mage.exe (マニフェストの生成および編集ツール)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md) diff --git a/includes/dnprdnshort-md.md b/includes/dnprdnshort-md.md new file mode 100644 index 00000000000..578b265eda1 --- /dev/null +++ b/includes/dnprdnshort-md.md @@ -0,0 +1 @@ +.NET Framework \ No newline at end of file diff --git a/includes/ndptecclick-md.md b/includes/ndptecclick-md.md new file mode 100644 index 00000000000..9354b8371a8 --- /dev/null +++ b/includes/ndptecclick-md.md @@ -0,0 +1 @@ +ClickOnce \ No newline at end of file diff --git a/includes/net-client-v40-long-md.md b/includes/net-client-v40-long-md.md new file mode 100644 index 00000000000..6eb2fced46b --- /dev/null +++ b/includes/net-client-v40-long-md.md @@ -0,0 +1 @@ +.NET Framework 4 Client Profile \ No newline at end of file diff --git a/includes/net-v20sp1-long-md.md b/includes/net-v20sp1-long-md.md new file mode 100644 index 00000000000..8c0ce41f6b4 --- /dev/null +++ b/includes/net-v20sp1-long-md.md @@ -0,0 +1 @@ +.NET Framework 2.0 Service Pack 1 \ No newline at end of file diff --git a/includes/net-v20sp1-short-md.md b/includes/net-v20sp1-short-md.md new file mode 100644 index 00000000000..9cf1b8e62db --- /dev/null +++ b/includes/net-v20sp1-short-md.md @@ -0,0 +1 @@ +.NET Framework 2.0 SP1 \ No newline at end of file diff --git a/includes/net-v35-long-md.md b/includes/net-v35-long-md.md new file mode 100644 index 00000000000..8c423191688 --- /dev/null +++ b/includes/net-v35-long-md.md @@ -0,0 +1 @@ + .NET Framework 3.5 diff --git a/includes/net-v35-short-md.md b/includes/net-v35-short-md.md new file mode 100644 index 00000000000..3b3e17628c7 --- /dev/null +++ b/includes/net-v35-short-md.md @@ -0,0 +1 @@ +.NET Framework 3.5 \ No newline at end of file diff --git a/includes/net-v35sp1-long-md.md b/includes/net-v35sp1-long-md.md new file mode 100644 index 00000000000..a4bbf5adf40 --- /dev/null +++ b/includes/net-v35sp1-long-md.md @@ -0,0 +1 @@ +.NET Framework 3.5 Service Pack 1 \ No newline at end of file diff --git a/includes/netfx35-short-md.md b/includes/netfx35-short-md.md new file mode 100644 index 00000000000..3b3e17628c7 --- /dev/null +++ b/includes/netfx35-short-md.md @@ -0,0 +1 @@ +.NET Framework 3.5 \ No newline at end of file diff --git a/includes/sqprsqext-md.md b/includes/sqprsqext-md.md new file mode 100644 index 00000000000..bebd01bc914 --- /dev/null +++ b/includes/sqprsqext-md.md @@ -0,0 +1 @@ +Microsoft SQL Server 2005 \ No newline at end of file diff --git a/includes/ssew-md.md b/includes/ssew-md.md new file mode 100644 index 00000000000..d3ab3d9099e --- /dev/null +++ b/includes/ssew-md.md @@ -0,0 +1 @@ +SQL Server Compact 3.5 \ No newline at end of file diff --git a/includes/ssnoversion-md.md b/includes/ssnoversion-md.md new file mode 100644 index 00000000000..9b0ee94fd50 --- /dev/null +++ b/includes/ssnoversion-md.md @@ -0,0 +1 @@ +SQL Server \ No newline at end of file diff --git a/includes/tla2sharptla-avalonwinfx-md.md b/includes/tla2sharptla-avalonwinfx-md.md new file mode 100644 index 00000000000..578b265eda1 --- /dev/null +++ b/includes/tla2sharptla-avalonwinfx-md.md @@ -0,0 +1 @@ +.NET Framework \ No newline at end of file diff --git a/includes/tla2sharptla-clickonce-md.md b/includes/tla2sharptla-clickonce-md.md new file mode 100644 index 00000000000..9354b8371a8 --- /dev/null +++ b/includes/tla2sharptla-clickonce-md.md @@ -0,0 +1 @@ +ClickOnce \ No newline at end of file diff --git a/includes/tla2sharptla-lhsdk-md.md b/includes/tla2sharptla-lhsdk-md.md new file mode 100644 index 00000000000..6da97bda29c --- /dev/null +++ b/includes/tla2sharptla-lhsdk-md.md @@ -0,0 +1 @@ +Windows SDK \ No newline at end of file diff --git a/includes/tla2sharptla-visualb-md.md b/includes/tla2sharptla-visualb-md.md new file mode 100644 index 00000000000..777515bcd7e --- /dev/null +++ b/includes/tla2sharptla-visualb-md.md @@ -0,0 +1 @@ +Visual Basic \ No newline at end of file diff --git a/includes/tla2sharptla-visualstu-md.md b/includes/tla2sharptla-visualstu-md.md new file mode 100644 index 00000000000..fe15234ba36 --- /dev/null +++ b/includes/tla2sharptla-visualstu-md.md @@ -0,0 +1 @@ +Visual Studio \ No newline at end of file diff --git a/includes/tla2sharptla-visualstu2005-md.md b/includes/tla2sharptla-visualstu2005-md.md new file mode 100644 index 00000000000..33fb76fddc1 --- /dev/null +++ b/includes/tla2sharptla-visualstu2005-md.md @@ -0,0 +1 @@ +Visual Studio 2005 \ No newline at end of file diff --git a/includes/tla2sharptla-wcsdk-md.md b/includes/tla2sharptla-wcsdk-md.md new file mode 100644 index 00000000000..6da97bda29c --- /dev/null +++ b/includes/tla2sharptla-wcsdk-md.md @@ -0,0 +1 @@ +Windows SDK \ No newline at end of file diff --git a/includes/tla2sharptla-winfx-md.md b/includes/tla2sharptla-winfx-md.md new file mode 100644 index 00000000000..578b265eda1 --- /dev/null +++ b/includes/tla2sharptla-winfx-md.md @@ -0,0 +1 @@ +.NET Framework \ No newline at end of file diff --git a/includes/tla2sharptla-winfxsdk-md.md b/includes/tla2sharptla-winfxsdk-md.md new file mode 100644 index 00000000000..6da97bda29c --- /dev/null +++ b/includes/tla2sharptla-winfxsdk-md.md @@ -0,0 +1 @@ +Windows SDK \ No newline at end of file diff --git a/includes/tlasharptla-aspnet-md.md b/includes/tlasharptla-aspnet-md.md new file mode 100644 index 00000000000..f41705de76e --- /dev/null +++ b/includes/tlasharptla-aspnet-md.md @@ -0,0 +1 @@ +ASP.NET \ No newline at end of file diff --git a/includes/tlasharptla-clickonce-md.md b/includes/tlasharptla-clickonce-md.md new file mode 100644 index 00000000000..9354b8371a8 --- /dev/null +++ b/includes/tlasharptla-clickonce-md.md @@ -0,0 +1 @@ +ClickOnce \ No newline at end of file diff --git a/includes/tlasharptla-lhsdk-md.md b/includes/tlasharptla-lhsdk-md.md new file mode 100644 index 00000000000..fc75fdfade4 --- /dev/null +++ b/includes/tlasharptla-lhsdk-md.md @@ -0,0 +1 @@ +Windows Software Development Kit (SDK) \ No newline at end of file diff --git a/includes/tlasharptla-titlewinfx-md.md b/includes/tlasharptla-titlewinfx-md.md new file mode 100644 index 00000000000..578b265eda1 --- /dev/null +++ b/includes/tlasharptla-titlewinfx-md.md @@ -0,0 +1 @@ +.NET Framework \ No newline at end of file diff --git a/includes/tlasharptla-winfxsdk-md.md b/includes/tlasharptla-winfxsdk-md.md new file mode 100644 index 00000000000..fc75fdfade4 --- /dev/null +++ b/includes/tlasharptla-winfxsdk-md.md @@ -0,0 +1 @@ +Windows Software Development Kit (SDK) \ No newline at end of file diff --git a/includes/vb-current-short-md.md b/includes/vb-current-short-md.md new file mode 100644 index 00000000000..777515bcd7e --- /dev/null +++ b/includes/vb-current-short-md.md @@ -0,0 +1 @@ +Visual Basic \ No newline at end of file diff --git a/includes/vbprvb-md.md b/includes/vbprvb-md.md new file mode 100644 index 00000000000..777515bcd7e --- /dev/null +++ b/includes/vbprvb-md.md @@ -0,0 +1 @@ +Visual Basic \ No newline at end of file diff --git a/includes/vbprvbext-md.md b/includes/vbprvbext-md.md new file mode 100644 index 00000000000..d2677871c70 --- /dev/null +++ b/includes/vbprvbext-md.md @@ -0,0 +1 @@ +Microsoft Visual Basic 2005 \ No newline at end of file diff --git a/includes/vbprvblong-md.md b/includes/vbprvblong-md.md new file mode 100644 index 00000000000..34139d90424 --- /dev/null +++ b/includes/vbprvblong-md.md @@ -0,0 +1 @@ +Visual Basic 2005 \ No newline at end of file diff --git a/includes/vbtecdlinq-md.md b/includes/vbtecdlinq-md.md new file mode 100644 index 00000000000..52781fca7e9 --- /dev/null +++ b/includes/vbtecdlinq-md.md @@ -0,0 +1 @@ +LINQ to SQL \ No newline at end of file diff --git a/includes/vs-current-short-md.md b/includes/vs-current-short-md.md new file mode 100644 index 00000000000..fe15234ba36 --- /dev/null +++ b/includes/vs-current-short-md.md @@ -0,0 +1 @@ +Visual Studio \ No newline at end of file diff --git a/includes/vs-dev10-long-md.md b/includes/vs-dev10-long-md.md new file mode 100644 index 00000000000..eaf2ee2b1c2 --- /dev/null +++ b/includes/vs-dev10-long-md.md @@ -0,0 +1 @@ +Visual Studio 2010 \ No newline at end of file diff --git a/includes/vs-dev11-ext-md.md b/includes/vs-dev11-ext-md.md new file mode 100644 index 00000000000..af7697e5649 --- /dev/null +++ b/includes/vs-dev11-ext-md.md @@ -0,0 +1 @@ +Microsoft Visual Studio 2012 \ No newline at end of file diff --git a/includes/vs-orcas-long-md.md b/includes/vs-orcas-long-md.md new file mode 100644 index 00000000000..80f0fb84087 --- /dev/null +++ b/includes/vs-orcas-long-md.md @@ -0,0 +1 @@ +Visual Studio 2008 \ No newline at end of file diff --git a/includes/vs-ordesigner-long-md.md b/includes/vs-ordesigner-long-md.md new file mode 100644 index 00000000000..00424e0c8fe --- /dev/null +++ b/includes/vs-ordesigner-long-md.md @@ -0,0 +1 @@ +Object Relational Designer \ No newline at end of file diff --git a/includes/vs2010-md.md b/includes/vs2010-md.md new file mode 100644 index 00000000000..eaf2ee2b1c2 --- /dev/null +++ b/includes/vs2010-md.md @@ -0,0 +1 @@ +Visual Studio 2010 \ No newline at end of file diff --git a/includes/vsprvs-md.md b/includes/vsprvs-md.md new file mode 100644 index 00000000000..fe15234ba36 --- /dev/null +++ b/includes/vsprvs-md.md @@ -0,0 +1 @@ +Visual Studio \ No newline at end of file diff --git a/includes/vsprvslong-md.md b/includes/vsprvslong-md.md new file mode 100644 index 00000000000..33fb76fddc1 --- /dev/null +++ b/includes/vsprvslong-md.md @@ -0,0 +1 @@ +Visual Studio 2005 \ No newline at end of file diff --git a/includes/vstecasp-md.md b/includes/vstecasp-md.md new file mode 100644 index 00000000000..f41705de76e --- /dev/null +++ b/includes/vstecasp-md.md @@ -0,0 +1 @@ +ASP.NET \ No newline at end of file diff --git a/includes/winsdk-md.md b/includes/winsdk-md.md new file mode 100644 index 00000000000..6da97bda29c --- /dev/null +++ b/includes/winsdk-md.md @@ -0,0 +1 @@ +Windows SDK \ No newline at end of file diff --git a/includes/winsdklong-md.md b/includes/winsdklong-md.md new file mode 100644 index 00000000000..fc75fdfade4 --- /dev/null +++ b/includes/winsdklong-md.md @@ -0,0 +1 @@ +Windows Software Development Kit (SDK) \ No newline at end of file diff --git a/includes/winsdkshort-md.md b/includes/winsdkshort-md.md new file mode 100644 index 00000000000..6da97bda29c --- /dev/null +++ b/includes/winsdkshort-md.md @@ -0,0 +1 @@ +Windows SDK \ No newline at end of file