Import-SPWeb
Web、リスト、またはライブラリをインポートします。
構文
Import-SPWeb
[-Identity] <SPWebPipeBind>
-Path <String>
[-ActivateSolutions]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Force]
[-HaltOnError]
[-HaltOnWarning]
[-IncludeUserCustomAction <SPIncludeUserCustomAction>]
[-IncludeUserSecurity]
[-NoFileCompression]
[-NoLogFile]
[-UpdateVersions <SPUpdateVersions>]
[-WhatIf]
[-PreserveDeletedUserMetadataReferences]
[<CommonParameters>]説明
Import-SPWeb コマンドレットでは、Web、リスト、またはライブラリをインポートします。 ライブラリからインポートする機能は、SharePoint 製品の新機能です。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
--------------------- 例 ----------------------
Import-SPWeb https://site -Path export.cmp -UpdateVersions Overwriteこの例では、export.cmp のコンテンツを https://site のサイトにインポートし、そのサイトのバージョン付きコンテンツをexport.cmp ファイルのコンテンツで上書きします。
パラメーター
-ActivateSolutions
インポート中にユーザー ソリューションをアクティブ化するかどうかを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Force
このパラメーターには、このコマンドレットに関数がありません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-HaltOnError
エラーが発生した場合、インポート処理を停止します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-HaltOnWarning
警告が発生した場合、インポート処理を停止します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
インポート先の Web の URL または GUID を指定します。
この型は、有効な URL、GUID、またはオブジェクト (http://<サーバー名> という形式の有効な URL または 1234-4567-5678a という形式の GUID など) であることが必要です。
| Type: | SPWebPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-IncludeUserCustomAction
インポート中にユーザー設定のアクションを含めるかどうかを指定します。
有効な値は次のとおりです。
すべて、なし
| Type: | SPIncludeUserCustomAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-IncludeUserSecurity
ユーザーのセキュリティ設定を保持します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-NoFileCompression
インポート パッケージのファイル圧縮を有効または無効にします。 インポート パッケージは、 Path パラメーターまたは Identity パラメーターで指定したフォルダーに格納されます。 パフォーマンス上の理由により、このパラメーターを使用することをお勧めします。 圧縮を有効にすると、インポート処理のパフォーマンスが約 30% 向上します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-NoLogFile
インポート ログ ファイルが生成されないようにします。 このパラメーターを指定しない場合、 Import-SPWeb コマンドレットによって、エクスポート パッケージと同じ場所にエクスポート ログ ファイルが生成されます。 ログ ファイルの生成には統合ログ サービス (ULS) が使用されます。
このパラメーターを使用することをお勧めします。 ただし、パフォーマンス上の問題がある場合は、ログ ファイルを生成しなくてもかまいません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Path
インポート ファイルの名前を指定します。
NoFileCompression パラメーターを使用する場合は、ディレクトリを指定する必要があります。このパラメーターを使用しない場合は、すべてのファイル形式が有効です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-PreserveDeletedUserMetadataReferences
SPUser オブジェクトがコピー先サイトで削除済みとしてマークされている場合でも、アイテムの 'Author' ('Created By') フィールドを計算しようとします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UpdateVersions
インポートするファイルが、既にそのサイトに存在する場合の状況を解決する方法を指定します。 UpdateVersions パラメーターが存在しない場合、インポート操作では既定で 1 (追加) の値が使用されます。
この型には、次のいずれかを指定する必要があります。
-Append。現在のファイルに新しいバージョンを追加します。
-ファイルとそのすべてのバージョンを上書きします (削除してから挿入)
-ファイルがコピー先に存在する場合は無視します
既定値は[現在のファイルに新しいバージョンを追加する] です。
有効な値は次のとおりです。
追加、無視、上書き
| Type: | SPUpdateVersions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |