Copy-SPSite

  • リファレンス
モジュール:
sharepoint-server
適用対象:
SharePoint Server Subscription Edition

サイト コレクションのコピーを作成します。

構文

Copy-SPSite
    [-Identity] <SPSitePipeBind>
    [-TargetUrl] <String>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-DestinationDatabase <SPContentDatabasePipeBind>]
    [-HostHeaderWebApplication <String>]
    [-PreserveSiteId]
    [<CommonParameters>]

説明

Copy-SPSite コマンドレットを使用して、サイト コレクションを、暗黙的に指定されたソース コンテンツ データベースから、指定したコンテンツ データベースにコピーします。

サイト コレクションのコピーには新しい URL と新しい SiteID が設定されます。 SQL Server を実行しているコンピューターにデータベース スナップショット機能がある場合は、コピープロセス中にデータが変更されないように、コピー中にソース データベースの一時的なスナップショットが作成されます。 SQL Serverを実行しているサーバーにデータベース スナップショット機能がない場合は、ソースをバックアップし、コピー先に復元して同じ結果を得ることができます。

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

例

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

Copy-SPSite https://contoso/sites/OldTeam -DestinationDatabase WSS_Content -TargetUrl https://contoso/sites/NewTeam

この例では、https://contoso/sites/OldTeam サイト コレクションを、そのサイト コレクションのデータベースから WSS_Content データベースにコピーします。その際、URL (https://contoso/sites/NewTeam とサイト ID も新しく設定されます。

パラメーター

-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

-DestinationDatabase

コピーの送信先を指定します。

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

-HostHeaderWebApplication

サイト コレクションがホスト名付きサイト コレクションであり、サイトが正しい Web アプリケーション上に置くことができる場合に使用します。

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

-Identity

コピーするサイト コレクションを指定します。 有効な URL または GUID を使用できます。

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

-PreserveSiteId

SiteID を保存するかどうかを指定します。

有効な値は True と False です。 既定値は False です。

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

-TargetUrl

サイト コレクションのコピーに使用する URL です。

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