Install-SPSolution

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

構文

Install-SPSolution
       [-Identity] <SPSolutionPipeBind>
       [-AllWebApplications]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-CASPolicies]
       [-CompatibilityLevel <String>]
       [-Confirm]
       [-Force]
       [-FullTrustBinDeployment]
       [-GACDeployment]
       [-Language <UInt32>]
       [-Local]
       [-Time <String>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [<CommonParameters>]
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 ソリューションをファーム内のすべての SharePoint Web アプリケーションに対して展開するように指定します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

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

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

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-CASPolicies

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-CompatibilityLevel

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

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

--14

--15

--14,15

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-FullTrustBinDeployment

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-GACDeployment

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

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

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

Type:SPSolutionPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Language

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Local

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Synchronize

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Time

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WebApplication

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

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

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

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

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

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition