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
コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
型: | SPAssignmentCollection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-Confirm
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-ContentDatabase
サイト コレクション データの保存場所となる SQL Server コンテンツ データベースを指定します。 コンテンツ データベースを指定しない場合は、未使用サイト コレクション容量が最大で、データベースの状態が準備完了であるコンテンツ データベースが使用されます。
型: | SPContentDatabasePipeBind |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-DatabaseName
サイト コレクション データの保存場所となる SQL Server コンテンツ データベースを指定します。 コンテンツ データベースを指定しない場合は、未使用サイト コレクション容量が最大で、データベースの状態が準備完了であるコンテンツ データベースが使用されます。
この型は、SQLDB1 という形式の有効なデータベース名であることが必要です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-DatabaseServer
DatabaseName パラメーターで指定したコンテンツ データベースを含む SQL Server の名前を指定します。
この型は、SQLBE1 という形式の有効なデータベース サーバー名で、 DatabaseName パラメーターと組み合わせて使用する必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-Force
URL の場所の既存のサイト コレクションがこの復元で上書きされるように指定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-GradualDelete
Force パラメーターで上書きされるサイト コレクションを一度にすべてではなくタイマー ジョブによって徐々に削除し、SharePoint 製品への影響を減らし、パフォーマンスをSQL Serverすることを指定します。 このオプションは、大規模なサイト コレクションに推奨されます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-HostHeaderWebApplication
代替アクセス マッピングを使用して Web アプリケーションに割り当てられた有効な URL ( など) https://server_name
サイト コレクションをパス ベースのサイト コレクションではなく、ホスト名が付いたサイト コレクションとして復元します。 HostHeaderWebApplication パラメーターを指定した場合、 Identity パラメーターの値はホスト名が付いたサイト コレクションの URL、 HostHeaderWebApplication パラメーターの値はホスト名が付いたサイト コレクションを保持する Web アプリケーションの URL です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-Identity
サイト コレクションが復元される URL の場所を指定します。
復元を実行する URL の場所にサイト コレクションが既に存在している必要はありません。 ただし、サイト コレクションを作成できる有効な URL の場所を指定する必要があります。 指定した URL の場所にサイト コレクションが既に存在する場合は、 Force パラメーターを指定してサイト コレクションを上書きする必要があります。
型は、フォーム内の有効な URL である必要があります https://server_name/sites/site_name.
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-Path
Specifies a valid path to the ___location of the backup. For example, C:\Backup\site_name.bak.
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-PreserveSiteID
新しいサイト ID を作成するのではなく、元のサイト ID を保持します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |
-WhatIf
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Server Subscription Edition |