Invoke-SPOSiteSwap
ジョブを呼び出して元のサイトをアーカイブしながら、別のサイトとサイトの場所を交換します。
構文
Default (既定)
Invoke-SPOSiteSwap
[-SourceUrl] <String>
[[-TargetUrl] <String>]
[-ArchiveUrl] <String>
[-DisableRedirection]
[-Force]
[-NoWait]
[<CommonParameters>]
説明
元のターゲット サイトをアーカイブしながら、ソース サイトの場所をターゲット サイトと交換します。
ターゲット サイトは次のいずれかである必要があることに注意してください:
- ルート サイト (
https://tenant-name.sharepoint.comなど)、または - 検索センター サイト (
https://tenant-name.sharepoint.com/searchなど)。
交換が開始されると、ターゲット サイトはアーカイブの場所に移動され、ソース サイトはターゲットの場所に移動されます。 既定では、ソースの場所にサイトのリダイレクトが作成され、トラフィックがターゲットの場所にリダイレクトされます。
ターゲットが https://tenant-name.sharepoint.com のルート サイトである場合、交換を実行する前に次の準備アクティビティを実行する必要があります。
- 交換の実行後、
https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspxの SharePoint の開始ページで定義されたおすすめリンクは、表示されません。 必要に応じて、交換後に手動で再作成できるように、おすすめリンクを文書化する必要があります。 - 外部共有やアプリケーション インターフェイスなどの機能は、ルートサイトで定義されたポリシーおよびアクセス許可に依存します。 ソース サイトを確認して、既存のルート サイトに従って必要なポリシーとアクセス許可があることを確認します。 これには、外部共有設定とサイトのアクセス許可が含まれます。
- 最大 10,000 個を超えるライセンスを持つ大規模なテナントでは、ソース サイトに対して ページ診断ツール を実行する必要があります (ページ診断ツールを実行しているユーザーがソース サイトで編集権限を持っていることを確認してください)。 分析結果のカテゴリに要注意 (赤) または改善の余地あり (黄) が表示されているものがあれば、交換を実行する前に修復する必要があります。
ソース サイトとターゲット サイトを Office 365 グループに接続することはできません。 また、ハブ サイトにすることも、ハブに関連付けることもできません。 サイトがハブ サイトである場合、ハブ サイトとして登録を解除し、ルート サイトを交換してから、サイトをハブ サイトとして登録します。 サイトがハブに関連付けられている場合は、サイトの関連付けを解除し、ルート サイトを交換してから、サイトを再度関連付けます。
発行機能が以前アクティブ化されていたり、現在ソース サイトでアクティブ化されていたりする場合、Invoke-SPOSiteSwap は使用できません。
例
例 1
Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive
https://contoso.sharepoint.com にある既存のサイトを https://contoso.sharepoint.com/sites/Archive にアーカイブし、https://contoso.sharepoint.com/sites/CommunicationSite を https://contoso.sharepoint.com. に移動します。https://contoso.sharepoint.com/sites/CommunicationSite にサイト リダイレクトが作成され、要求を https://contoso.sharepoint.com. にリダイレクトします
例 2
Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive
https://contoso.sharepoint.com/search にある既存の検索センター サイトを https://contoso.sharepoint.com/sites/Archive にアーカイブし、https://contoso.sharepoint.com/sites/SearchSite を https://contoso.sharepoint.com/search. に移動します。https://contoso.sharepoint.com/sites/SearchSite にサイト リダイレクトが作成され、要求を https://contoso.sharepoint.com/search. にリダイレクトします
例 3
Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -DisableRedirection
https://contoso.sharepoint.com にある既存のサイトを https://contoso.sharepoint.com/sites/Archive にアーカイブし、https://contoso.sharepoint.com/sites/CommunicationSite を https://contoso.sharepoint.com. に移動します。https://contoso.sharepoint.com/sites/CommunicationSite. にサイト リダイレクトは作成されません。
例 4
Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -Force
https://contoso.sharepoint.com/search にある既存の検索センター サイトを https://contoso.sharepoint.com/sites/Archive にアーカイブし、https://contoso.sharepoint.com/sites/SearchSite を https://contoso.sharepoint.com/search. に移動します。https://contoso.sharepoint.com/sites/SearchSite にサイト リダイレクトが作成され、要求を https://contoso.sharepoint.com/search. にリダイレクトします。ページ診断ツールによって識別された警告は無視され、交換を開始します。 ただし、ページ診断ツールによって識別されたエラーがある場合は、交換は開始されません。
パラメーター
-ArchiveUrl
適用対象: SharePoint Online
ターゲット サイトがアーカイブされる URL。 交換を実行する前に、この場所に既存のサイト (ごみ箱内の削除されたサイトも含む) が存在しないようにする必要があります。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DisableRedirection
適用対象: SharePoint Online
ソース URL ロケーションでのサイト リダイレクトの作成を無効にします。
パラメーターのプロパティ
| 型: | Switch Parameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
適用対象: SharePoint Online
交換の開始を妨げているページ診断ツールで識別された警告を、オーバーライドし、無視します。
たとえば、"Invoke-SPOSiteSwap: Errors: 0; という警告を受け取った場合。警告: 1;詳細: 2 つの項目が CDN に含まれていない場合は、CDN を有効にしてください。警告は、このパラメーターを使用してオーバーライドできますが、長期的な安定性とパフォーマンスのために項目を確認して解決する必要があります。
このパラメーターに関係なく、ページ診断ツールによって識別されたエラーがある場合は、交換は開始されません。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NoWait
適用対象: SharePoint Online
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SourceUrl
適用対象: SharePoint Online
ソース サイトの URL。 交換を実行する前に、この場所のサイトが存在している必要があります。
ターゲットが https://tenant-name.sharepoint.com のルート サイトである場合、ソース サイトはモダン チーム サイト (STS#3)、またはコミュニケーション サイト (SITEPAGEPUBLISHING#0) のいずれかでなければなりません。そして、公開機能がソース サイト上でアクティブ化されることはありません。
ターゲットが https://tenant-name.sharepoint.com/search の検索センター サイトである場合、ソース サイトは検索センター サイト (SRCHCEN#0) または基本検索センター サイト (SRCHCENTERLITE#0) のいずれかでなければなりません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TargetUrl
適用対象: SharePoint Online
ソース サイトが交換されるターゲット サイトの URL。 交換を実行する前に、この場所のサイトが存在している必要があります。
ターゲット サイトは次のいずれかである必要があります。
-
https://tenant-name.sharepoint.comのルート サイト、または -
https://tenant-name.sharepoint.com/searchの検索センター サイト
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。