SharePoint ソリューション パッケージの配置、発行、およびアップグレードを行う

Visual Studio で SharePoint ソリューションを開発した後、そのパッケージ (.wsp) ファイルをローカル SharePoint サーバーに配置するか、リモートまたはローカル SharePoint サーバーに発行できます。 ファイルを配置する場合は、パッケージファイル (.wsp) の配置方法をカスタマイズできます。

Note

現時点では、リモートの SharePoint サーバーに発行できるのは、サンドボックス化されたソリューションのみです。 詳細については、「サンドボックス ソリューションに関する考慮事項」を参照してください。

配置、発行、およびアップグレード

"配置" とは、Visual Studio で SharePoint プロジェクトからビルドされた SharePoint ソリューション ファイルをローカル ホストにコピーすることを指します。 配置されるソリューションでは、インターネット インフォメーション サービス (IIS) プールのリサイクル、配置後のソリューションのアクティブ化などの配置手順を構成できます。 配置するには、[ビルド] メニューの [配置] コマンドを使用します。 詳細については、「方法: SharePoint の配置構成を編集する」と「方法: SharePoint ソリューションのローカル SharePoint サイトへの配置と発行を行う」を参照してください。

"発行" とは、サンドボックス化された SharePoint ソリューション ファイルをリモート SharePoint サイト (別のシステムに配置されているサイト) にアップロードすることを指します。 SharePoint サンドボックス ソリューション ファイルをローカル SharePoint サイトに発行することもできますが、発行先のサイトがローカルであるかリモートであるかに関係なく、その配置手順を構成することはできません。

"アップグレード" とは、既存のリモートまたはローカルに発行された SharePoint ソリューションを更新することを指します。 Visual Studio で SharePoint ソリューションを変更した後、ソリューションのパッケージ ファイル名を変更し、ソリューションを再発行します。ソリューションが正常に再発行された後、それをアップグレードします。 ローカルに発行されたソリューションを再発行する場合は、既存のソリューション ファイルを上書きできます。

パッケージの配置

テストとデバッグを目的として、開発用コンピューターの SharePoint サーバーにパッケージ ファイルを配置できます。 [発行] ダイアログ ボックスの [ファイル システムに発行] オプションボタンを選択することで、別のコンピューターにインストールできるパッケージ ファイルを作成することもできます。 パッケージが作成され、指定したローカル ファイル パスにコピーされます。 SharePoint ソリューションをローカル サーバーに配置するには、[ビルド] メニューの [配置] を使用します。 詳細については、「SharePoint ソリューションのローカル SharePoint サイトへの配置と発行を行う」を参照してください。

リスト定義を配置する方法、イベント レシーバーを追加する方法、およびフィーチャー デザイナーとパッケージ デザイナーを使用する方法については、「チュートリアル: プロジェクト タスク リスト定義を配置する」を参照してください。

配置プロセスをカスタマイズする

次の表は、SharePoint ソリューションのデバッグと配置を行うときに使用できる 2 つの配置構成を示しています。

デプロイの構成 説明
Default 既定の配置構成。 次の配置手順が実行されます。

1. 配置前コマンドを実行する。
2. IIS アプリケーション プールをリサイクルする。
3. ソリューションを取り消す。
4. ソリューションを追加する。
5. 機能をアクティブ化する。
6. 配置後コマンドを実行する。

パッケージがアンインストールされると、次の取り消し手順が実行されます。

1. IIS アプリケーション プールをリサイクルする。
2. ソリューションを取り消す。
アクティブ化なし この配置構成では、[既定] の構成と同じ手順が実行されますが、アクティブ化手順はスキップされます。

独自の配置構成を作成して、1 つの手順を完了したり、配置プロセス手順の順序を変更したりすることができます。 詳細については、「方法:SharePoint の配置構成を編集する」 を参照してください。

配置の前後に実行するコマンドを追加することもできます。 詳細については、「方法: SharePoint 配置コマンドを設定する」を参照してください。

リモートまたはローカル サーバーにパッケージを発行する

サンドボックス化された SharePoint ソリューションをリモート サーバーに発行するには、メニュー バーで [ビルド][発行] の順に選択します。[発行] ダイアログ ボックスで [SharePoint サイトに発行] を選択し、リモート サーバーの URL (https://someremoteserver.sharepoint.microsoftonline.com など) を指定します。

SharePoint ソリューションをローカル サーバーに発行するには、[発行] ダイアログ ボックスで、[ファイル システムに発行] オプションを選択し、ローカル システム パスを指定します。

ソリューションが SharePoint に正常に発行されると、ソリューション ギャラリーにソリューションが表示され、アクティブ化できるようになります。 詳細については、「方法: リモート サーバー上で SharePoint ソリューションの配置、発行、およびアップグレードを行う」を参照してください。

発行済みのパッケージをアップグレードする

SharePoint プロジェクトの発行後に Visual Studio で何らかの変更を行った場合は、変更を含めるように発行済みのパッケージをアップグレードする必要があります。 正常にアップグレードするには、パッケージの名前が一意である必要があります。 SharePoint サイトで同じ名前のパッケージが見つかった場合 (既存のアプリケーションを更新するときに発生する可能性があります)、ファイル名の競合を警告するエラー メッセージが表示され、パッケージの名前を変更できます。 再発行すると、SharePoint サイトに新しいパッケージが表示され、アップグレードできます。 アップグレードされるパッケージでは、古いパッケージのデータを使用してソリューションが更新された後、SharePoint でソリューションがアクティブ化されます。 詳細については、「方法: リモート サーバー上で SharePoint ソリューションの配置、発行、およびアップグレードを行う」を参照してください。