Install-SPWebPartPack

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

指定した Web パーツパッケージを指定した場所にインストールします。

構文

Install-SPWebPartPack
       [-LiteralPath] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-GlobalInstall]
       [-Language <UInt32>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [-CompatibilityLevel <String>]
       [<CommonParameters>]

Install-SPWebPartPack
       [-Name] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-GlobalInstall]
       [-Language <UInt32>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [-CompatibilityLevel <String>]
       [<CommonParameters>]

説明

このコマンドレットには、複数のパラメーターセットが含まれています。使用できるのは、1 つのパラメーターセットのパラメーターだけであり、異なるパラメーターセットのパラメーターを組み合わせることはできません。パラメーターセットの使用法に関する詳しい情報については、「コマンドレットのパラメーターセット」を参照してください。

Install-SPWebPartPack コマンドレットでは、ローカルファーム内の LiteralPath パラメーターで指定した場所に、Web パーツパッケージをインストールします。 WebApplication パラメーターを使用して、特定の Web アプリケーションに Web パーツパッケージをインストールすることができます。 Web アプリケーションを指定しない場合は、すべての Web アプリケーションに Web パーツパッケージがインストールされます。

パッケージの言語を指定するには、Language パラメーターを使用します。

パッケージをグローバルアセンブリキャッシュ (GAC) にインストールするには、GlobalInstall パラメーターを使用します。 GAC 内のアセンブリには FullTrust 権限が付与され、システム全体のリソースに完全にアクセスできるようになります。

同じ名前や同じインストール先の既存の Web パーツパッケージを上書きしてインストールする場合は、Force パラメーターを使用します。

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

例

------------------ 例 ------------------

Install-SPWebPartPack "MyCustomWebPartPack" -LiteralPath "C:\mywebpart.wpp" -GlobalInstall

この例では、MyCustomWebPartPack という名前の Web パーツパッケージをパス c:/mywebpart.wpp からファームにグローバルにインストールします。

パラメーター

-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

-CompatibilityLevel

新しい SPSite オブジェクトを作成するとき、使用するテンプレートのバージョンを指定します。この値は、サイトコレクションの CompatibilityLevel の初期値を設定します。このパラメーターを指定しないと、CompatibilityLevel は、SiteCreationMode の設定に応じて、Web アプリケーションで指定できる最高のバージョンに既定で設定されます。

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

同じ名前や同じインストール先の既存の Web パーツパッケージを上書きしてインストールします。

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

-GlobalInstall

各 Web アプリケーションの /bin ディレクトリではなく、グローバルアセンブリキャッシュ (GAC) に Web パーツパッケージをインストールします。これにより、その Web パーツがサーバー上でグローバルにアクセスできるようになります。

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

-Language

Web パーツパッケージの言語 ID を指定します。

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

-LiteralPath

Web パーツパッケージの正確なパスを指定します。

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

-Name

インストールする Web パーツパッケージの名前を指定します。

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

-WebApplication

Web パーツパッケージをインストールする Web アプリケーションを指定します。 Web アプリケーションを指定しない場合、Web パーツパッケージはすべての Web アプリケーションにインストールされます。

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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

次の方法で共有