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 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

-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

このパラメーターには、このコマンドレットに関数がありません。

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

-HaltOnError

エラーが発生した場合、インポート処理を停止します。

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

-HaltOnWarning

警告が発生した場合、インポート処理を停止します。

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

-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 Subscription Edition

-IncludeUserCustomAction

インポート中にユーザー設定のアクションを含めるかどうかを指定します。

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

すべて、なし

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

-IncludeUserSecurity

ユーザーのセキュリティ設定を保持します。

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

-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 Subscription Edition

-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 Subscription Edition

-Path

インポート ファイルの名前を指定します。

NoFileCompression パラメーターを使用する場合は、ディレクトリを指定する必要があります。このパラメーターを使用しない場合は、すべてのファイル形式が有効です。

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

-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 Subscription Edition

-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 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