Install-SPSolution

モジュール:

SharePointServer module

インストール済みの SharePoint ソリューションをファームに展開します。

構文

Deploy

Install-SPSolution
    [-Identity] <SPSolutionPipeBind>
    [-AllWebApplications]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CASPolicies]
    [-CompatibilityLevel <String>]
    [-Confirm]
    [-Force]
    [-FullTrustBinDeployment]
    [-GACDeployment]
    [-Language <UInt32>]
    [-Local]
    [-Time <String>]
    [-WebApplication <SPWebApplicationPipeBind>]
    [-WhatIf]
    [<CommonParameters>]

Synchronize

Install-SPSolution
    [[-Identity] <SPSolutionPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Language <UInt32>]
    [-Synchronize]
    [-WhatIf]
    [<CommonParameters>]

説明

このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用方法の詳細については、「コマンドレット パラメーター セット (https://learn.microsoft.com/powershell/scripting/developer/cmdlet/cmdlet-parameter-sets?view=powershell-5.1)」を参照してください。

Install-SPSolution コマンドレットでは、インストール済みの SharePoint ソリューションをファームに展開します。 SharePoint ソリューション パッケージをファームにインストールするには、Add-SPSolution コマンドレットを使用します。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

例

例 1

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment

この例では、インストール済みの SharePoint ソリューション contoso_solution.wsp をファームに展開し、新しい SharePoint ソリューションについて GAC を展開できるように指定します。

例 2

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment -CompatibilityLevel {14,15}

この例では、事前に追加されたインストール済みの SharePoint ソリューションを、14 モードと 15 モードの両方のサイト コレクションで正しく使用できるように展開します。

パラメーター

-AllWebApplications

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

新しい SharePoint ソリューションをファーム内のすべての SharePoint Web アプリケーションに対して展開するように指定します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-AssignmentCollection

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

パラメーターのプロパティ

型:	SPAssignmentCollection
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-CASPolicies

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

新しい SharePoint ソリューションに対してコード アクセス セキュリティ (CAS) ポリシーを展開できるように指定します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-CompatibilityLevel

該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

CompatibilityLevel に基づく特定バージョンのディレクトリにソリューションをインストールするかどうかを指定します。 このパラメーターを指定しなかった場合の既定の動作では、ソリューションの cab ファイルのマニフェストで追跡されるバージョンに基づくバージョン ディレクトリのみにソリューションをインストールします。

有効な値は次のとおりです。

--14

--15

--14,15

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Confirm

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

コマンドを実行する前に確認メッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	cf

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Force

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

新しい SharePoint ソリューションを強制的に展開します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-FullTrustBinDeployment

該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

完全信頼の bin 展開を許可することを指定します。 このパラメーターは、ソリューションを完全に信頼する場合に使用します。

bin アセンブリは、仮想サーバーの bin ディレクトリ内にインストールされたアセンブリです。 パッケージ内のアセンブリには、DeploymentTarget=WebApplication 属性が設定されています。 bin アセンブリについて詳しくは、「Assembly 要素」をご覧ください。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-GACDeployment

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

新しい SharePoint ソリューションについて、グローバル アセンブリ キャッシュ (GAC) を展開できるように指定します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Identity

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

展開する SharePoint ソリューションを指定します。

この値は、12345678-90ab-cdef-1234-567890bcdefgh という形式の正規の GUID であるか、SharePoint ソリューションの正規の名前 (SPSolution1 など) であるか、正規の SPSolution オブジェクト インスタンスであることが必要です。

パラメーターのプロパティ

型:	SPSolutionPipeBind
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	1
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

Synchronize

配置:	1
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Language

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

ソリューションの言語パッケージが展開されている場合にソリューションの言語を指定します。 指定しない場合、このパラメーターはゼロ ("0") であるとみなされます。 ソリューションがすべての言語に対して有効な場合はゼロを使用します。

パラメーターのプロパティ

型:	UInt32
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Local

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

アクティブなサーバーにソリューションを展開します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Synchronize

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

ローカル ファーム内のすべてのソリューションまたは指定されたソリューションを同期します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Synchronize

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Time

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

ソリューションを展開するタイミングを指定します。 既定値は即時展開です。

この型は、2010, 5, 1 という形式の有効な DateTime 値であることが必要です。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-WebApplication

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

指定された SharePoint Web アプリケーションに対して SharePoint ソリューションを展開します。

以下のいずれかの値を指定します。

--12345678-90ab-cdef-1234-567890bcdefgh 形式の本物の GUID

--SharePoint Web アプリケーションの本物の名前 (MyOfficeApp1 など)

--本物の SPWebApplication オブジェクトのインスタンス。

パラメーターのプロパティ

型:	SPWebApplicationPipeBind
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Deploy

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-WhatIf

該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	ウィスコンシン

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。