注: PowerShell 統合には、ShareGate Migrate の Pro または Enterprise サブスクリプションが必要です。Essentials プランでは使用できません。
コマンド
Copy-Site
説明
SharePoint サイトから別のサイトへサイトをコピーするコマンドです。
注:
Insane モードは既定で使用されるため(-NormalMode を指定しない限り)、このコマンドは既定で Microsoft 365 の Azure インポートが完了するまで待機してから処理を返します。ローカル処理の完了後すぐに処理を返すには、代わりに -NoWaitForImportCompletion を使用してください。この場合、返される結果は暫定的なものであり(インポートの内容はまだ反映されていません)、インポートが実際に完了したタイミングを確認するには Wait-ImportCompletion を使用するか、現在の PowerShell セッションを実行したままにしてください。以前の -WaitForImportCompletion スイッチは、完了を待機する動作が既定になったため、現在は非推奨です。
ShareGate Migrate は、PowerShell を使用してサイト コレクションをプロビジョニングすることはできません。移行先として中央管理サイト、管理センター、またはルート サイト コレクションの URL を指定して Copy-Site を実行すると、ルート サイト コレクションを損傷する可能性があります。
ヒント:
Copy-Siteスクリプトを調整して増分移行を実行する方法については、PowerShell で増分移行を実行するを参照してください。PowerShell でコピー オプションを使用する方法については、PowerShell のコピー オプションを参照してください。
例
サイトを、そのサブサイトを含めて移行先のサイトとマージする。
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
Copy-Site -Site $srcSite -DestinationSite $dstSite -Merge -Subsites
サイトを移行先サイトのサブサイトとしてコピーする。
Copy-Site -Site $srcSite -DestinationSite $dstSite
ソース サイトのサブサイトを取得し、それらを移行先サイトにコピーする。
$toCopy = Get-Subsite -Site $srcSite
Copy-Site -Site $toCopy -DestinationSite $dstSite
ソース サイトのすべてのサブサイトを移行先サイトにコピーする。
Copy-Site -All -SourceSite $srcSite -DestinationSite $dstSite
サイトをサブサイトとしてコピーする前に事前確認を実行する。
Copy-Site -Site $srcSite -DestinationSite $dstSite -WhatIf
指定したパターンに一致する名前を持つサブサイトをいくつかコピーする。
Copy-Site -Name MyName*,MySpecificName -SourceSite $srcSite -DestinationSite $dstSite
サブサイトをコピーして名前を変更する。
Copy-Site -Name MyName*,MySpecificName -SourceSite $srcSite -DestinationSite $dstSite -SiteTitle MyNewName -SiteTitleUrlSegment MyNewUrl
サイトを、そのサブサイトを含めて移行先のサイトとマージし、コンテンツと構造の両方に適用された機密ラベルをコピーする。
Copy-Site -Site $srcSite -DestinationSite $dstSite -Merge -Subsites -IncludeStructureSensitivityLabel -IncludeContentSensitivityLabel
Microsoft 365 の Azure インポートの完了を待たずにサイトをコピーし、その後 Wait-ImportCompletion を使用して完了のタイミングを確認する。
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
Copy-Site -Site $srcSite -DestinationSite $dstSite -NoWaitForImportCompletion
Wait-ImportCompletion
構文
以下は、Copy-Site コマンドで組み合わせて使用できるパラメーターのセットです。
Copy-Site
-Site <Site[]>-DestinationSite <Site>[-Merge <SwitchParameter>][-NoNavigation <SwitchParameter>][-Subsites <SwitchParameter>][-SiteTitle <String>][-SiteTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-WhatIf <SwitchParameter>][-TaskName <String>][-IncludeStructureSensitivityLabel <SwitchParameter>][-IncludeContentSensitivityLabel <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>]
Copy-Site
-Name <String[]>-SourceSite <Site>-DestinationSite <Site>[-Merge <SwitchParameter>][-NoNavigation <SwitchParameter>][-Subsites <SwitchParameter>][-SiteTitle <String>][-SiteTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-WhatIf <SwitchParameter>][-TaskName <String>][-IncludeStructureSensitivityLabel <SwitchParameter>][-IncludeContentSensitivityLabel <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>]
Copy-Site
-All <SwitchParameter>-SourceSite <Site>-DestinationSite <Site>[-Merge <SwitchParameter>][-NoNavigation <SwitchParameter>][-Subsites <SwitchParameter>][-SiteTitle <String>][-SiteTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-WhatIf <SwitchParameter>][-TaskName <String>][-IncludeStructureSensitivityLabel <SwitchParameter>][-IncludeContentSensitivityLabel <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>]
PowerShell では、次のスクリプトを使用して任意のコマンドの構文を取得できます:
Get-Command Copy-Site -SyntaxParameters
パラメーター
-All <SwitchParameter>
すべてをコピーすることを指定します。
必須 | True |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | All |
エイリアス | None |
-CopySettings <CopySettings>
コピー設定を指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-DestinationSite <Site>
移行先のサイトを指定します。
必須 | True |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-ForceNewListExperience <SwitchParameter>
可能な場合、コマンドがリストを新しい Microsoft 365 エクスペリエンスに変換することを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-IncludeContentSensitivityLabel <SwitchParameter>
Document library に保存されているコンテンツ (フォルダーを除くファイル) に適用された機密ラベルを、機密ラベルのマッピングを使用して移行先にコピーすることを指定します。ソースと移行先の両方が SharePoint Online である必要があります。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-IncludeStructureSensitivityLabel <SwitchParameter>
構造オブジェクト (Site collection、それに接続された Microsoft 365 Group、および Document library) に適用された機密ラベルを、機密ラベルのマッピングを使用して移行先にコピーすることを指定します。ソースと移行先の両方が SharePoint Online である必要があります。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-MappingSettings <MappingSettings>
マッピング設定を指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-Merge <SwitchParameter>
サイトをサブサイトとして追加する代わりに、移行先のサイトとマージすることを指定します。このパラメーターは、複数のサイトをコピーする場合には使用できません。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-Name <String[]>
名前を指定します(ワイルドカードに対応)。
必須 | True |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | True |
パラメーター セット名 | Name |
エイリアス | None |
-NoContent <SwitchParameter>
リストとライブラリ内のすべてのリスト項目、ドキュメント、フォルダー、およびドキュメント セットがコピーされないことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoCustomizedListForms <SwitchParameter>
カスタマイズされたリスト フォームおよびコンテンツ タイプ フォームがコピーされないことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoCustomPermissions <SwitchParameter>
すべての項目が親から権限を継承するように設定されることを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoListViews <SwitchParameter>
リスト ビューがコピーされないことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoNavigation <SwitchParameter>
コピー中にサイトのナビゲーションおよびクイック起動の設定が保持されないことを指定します。指定した場合、これらの設定は移行先のサイトで既定値に設定されます。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoNintexWorkflowHistory <SwitchParameter>
移行されるオブジェクトに関連付けられた Nintex ワークフローの履歴が移行先にコピーされないことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NormalMode <SwitchParameter>
通常モードを使用することを指定します。
注: PowerShell では既定で Insane mode が常に使用されます。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoSiteFeatures <SwitchParameter>
コピーされる要素に必要なサイトおよび Site collection の機能が自動的に有効化されないことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoWaitForImportCompletion <SwitchParameter>
ローカル処理の完了後、Azure の Insane mode インポートの完了を待たずにコマンドが処理を返すことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoWebParts <SwitchParameter>
ページをコピーする際に Web パーツがコピーされないことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-NoWorkflows <SwitchParameter>
移行されるオブジェクトに関連付けられたワークフローが移行先にコピーされないことを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-Site <Site[]>
コピーするソース サイトを指定します。
必須 | True |
デフォルト値 | None |
パイプライン入力を許可しますか? | True (ByValue, ByPropertyName) |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | Default |
エイリアス | None |
-SiteTitle <String>
新しいサイト タイトルを指定します。このパラメーターは 'SiteTitleUrlSegment' パラメーターと併用する必要があり、複数のサイトをコピーする場合には使用できません。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-SiteTitleUrlSegment <String>
親サイトからの相対パスとなる新しいサイト URL を指定します。このパラメーターは 'SiteTitle' パラメーターと併用する必要があり、複数のサイトをコピーする場合には使用できません。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-SourceSite <Site>
ソース サイトを指定します。
必須 | True |
デフォルト値 | None |
パイプライン入力を許可しますか? | True (ByValue, ByPropertyName) |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | Name, All |
エイリアス | None |
-Subsites <SwitchParameter>
ソース サイトのすべてのサブサイトがコピーされることを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-TaskName <String>
タスクの名前を指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-UserAlerts <SwitchParameter>
移行されるオブジェクトに関連付けられたユーザー アラートが移行先にコピーされることを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-VersionLimit <Int32>
最新の X バージョンをコピーし、常に少なくとも 1 つのメジャー バージョンを保持することを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
-WhatIf <SwitchParameter>
移行の代わりに事前確認が実行されることを指定します。
必須 | False |
デフォルト値 | None |
パイプライン入力を許可しますか? | False |
ワイルドカード文字を許可しますか? | False |
パラメーター セット名 | (All) |
エイリアス | None |
この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。