Restore-SPSite

サイト コレクションを復元します。

構文

Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-ContentDatabase <SPContentDatabasePipeBind>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]
Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-DatabaseName <String>]
       [-DatabaseServer <String>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]

説明

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

コマンドレットは Restore-SPSite 、Identity パラメーターで指定された場所にサイト コレクションの復元を実行します。 コンテンツ データベースには、サイト コレクションの 1 つのコピーのみが含まれる場合があります。 サイト コレクションがバックアップされ、同じ Web アプリケーション内の別の URL の場所に復元される場合は、サイト コレクションの復元されたコピーを保持するために追加のコンテンツ データベースを利用可能にする必要があります。

---------------------- 例 1 ----------------------

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak

次の使用例は、バックアップ ファイル C:\Backup\site_name.bak からサイト コレクション URL にサイト コレクションを復元します https://server_name/sites/site_name.

---------------------- 例 2 ----------------------

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak -Force -DatabaseServer SQLBE1 -DatabaseName SQLDB1

次の使用例は、バックアップ ファイル C:\Backup\site_name.bak からサイト コレクションのバックアップを復元しますが、サイト コレクションを特定のコンテンツ データベースに格納する必要があることを指定しながら、 の https://server_name/sites/site_name 既存のサイト コレクションを上書きします。

---------------------- 例 3 ----------------------

Restore-SPSite https://www.example.com -Path \\file_server\share\site_name.bak -HostHeaderWebApplication https://server_name

次の使用例は、バックアップ ファイル \\file_server\share\site_name.bak から Web アプリケーション上のホスト名付きサイト コレクションにサイト コレクション https://www.example.com のバックアップを復元します https://server_name.

パラメーター

-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

-ContentDatabase

サイト コレクション データの保存場所となる SQL Server コンテンツ データベースを指定します。 コンテンツ データベースを指定しない場合は、未使用サイト コレクション容量が最大で、データベースの状態が準備完了であるコンテンツ データベースが使用されます。

Type:SPContentDatabasePipeBind
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

-DatabaseName

サイト コレクション データの保存場所となる SQL Server コンテンツ データベースを指定します。 コンテンツ データベースを指定しない場合は、未使用サイト コレクション容量が最大で、データベースの状態が準備完了であるコンテンツ データベースが使用されます。

この型は、SQLDB1 という形式の有効なデータベース名であることが必要です。

Type:String
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

-DatabaseServer

DatabaseName パラメーターで指定したコンテンツ データベースを含む SQL Server の名前を指定します。

この型は、SQLBE1 という形式の有効なデータベース サーバー名で、 DatabaseName パラメーターと組み合わせて使用する必要があります。

Type:String
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

URL の場所の既存のサイト コレクションがこの復元で上書きされるように指定します。

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

-GradualDelete

Force パラメーターで上書きされるサイト コレクションを一度にすべてではなくタイマー ジョブによって徐々に削除し、SharePoint 製品への影響を減らし、パフォーマンスをSQL Serverすることを指定します。 このオプションは、大規模なサイト コレクションに推奨されます。

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

-HostHeaderWebApplication

代替アクセス マッピングを使用して Web アプリケーションに割り当てられた有効な URL ( など) https://server_name

サイト コレクションをパス ベースのサイト コレクションではなく、ホスト名が付いたサイト コレクションとして復元します。 HostHeaderWebApplication パラメーターを指定した場合、 Identity パラメーターの値はホスト名が付いたサイト コレクションの URL、 HostHeaderWebApplication パラメーターの値はホスト名が付いたサイト コレクションを保持する Web アプリケーションの URL です。

Type:String
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

サイト コレクションが復元される URL の場所を指定します。

復元を実行する URL の場所にサイト コレクションが既に存在している必要はありません。 ただし、サイト コレクションを作成できる有効な URL の場所を指定する必要があります。 指定した URL の場所にサイト コレクションが既に存在する場合は、 Force パラメーターを指定してサイト コレクションを上書きする必要があります。

型は、フォーム内の有効な URL である必要があります https://server_name/sites/site_name.

Type:String
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

-Path

Specifies a valid path to the location of the backup. For example, C:\Backup\site_name.bak.

Type:String
Position:Named
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

-PreserveSiteID

新しいサイト ID を作成するのではなく、元のサイト ID を保持します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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