Invoke-SPOSiteSwap

  • リファレンス
モジュール:
Microsoft.Online.SharePoint.PowerShell
適用対象:
SharePoint Online

ジョブを呼び出して元のサイトをアーカイブしながら、別のサイトとサイトの場所を交換します。

構文

Invoke-SPOSiteSwap
         -SourceUrl <string>
         -TargetUrl <string>
         -ArchiveUrl <string>
         [-DisableRedirection]
         [-Force]
         [-NoWait]   
      [<CommonParameters>]

説明

元のターゲット サイトをアーカイブしながら、ソース サイトの場所をターゲット サイトと交換します。

ターゲット サイトは次のいずれかである必要があることに注意してください:

交換が開始されると、ターゲット サイトはアーカイブの場所に移動され、ソース サイトはターゲットの場所に移動されます。 既定では、ソースの場所にサイトのリダイレクトが作成され、トラフィックがターゲットの場所にリダイレクトされます。

ターゲットが https://tenant-name.sharepoint.com のルート サイトである場合、交換を実行する前に次の準備アクティビティを実行する必要があります。

  1. 交換の実行後、https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx の SharePoint の開始ページで定義されたおすすめリンクは、表示されません。 必要に応じて、交換後に手動で再作成できるように、おすすめリンクを文書化する必要があります。
  2. 外部共有やアプリケーション インターフェイスなどの機能は、ルートサイトで定義されたポリシーおよびアクセス許可に依存します。 ソース サイトを確認して、既存のルート サイトに従って必要なポリシーとアクセス許可があることを確認します。 これには、外部共有設定とサイトのアクセス許可が含まれます。
  3. 最大 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

ターゲット サイトがアーカイブされる URL。 交換を実行する前に、この場所に既存のサイト (ごみ箱内の削除されたサイトも含む) が存在しないようにする必要があります。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DisableRedirection

ソース URL ロケーションでのサイト リダイレクトの作成を無効にします。

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Force

交換の開始を妨げているページ診断ツールで識別された警告を、オーバーライドし、無視します。

たとえば、"Invoke-SPOSiteSwap: Errors: 0; という警告を受け取った場合。警告: 1;詳細: 2 つの項目が CDN に含まれていない場合は、CDN を有効にしてください。警告は、このパラメーターを使用してオーバーライドできますが、長期的な安定性とパフォーマンスのために項目を確認して解決する必要があります。

このパラメーターに関係なく、ページ診断ツールによって識別されたエラーがある場合は、交換は開始されません。

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-NoWait

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-SourceUrl

ソース サイトの URL。 交換を実行する前に、この場所のサイトが存在している必要があります。

ターゲットが https://tenant-name.sharepoint.com のルート サイトである場合、ソース サイトはモダン チーム サイト (STS#3)、またはコミュニケーション サイト (SITEPAGEPUBLISHING#0) のいずれかでなければなりません。そして、公開機能がソース サイト上でアクティブ化されることはありません。

ターゲットが https://tenant-name.sharepoint.com/search の検索センター サイトである場合、ソース サイトは検索センター サイト (SRCHCEN#0) または基本検索センター サイト (SRCHCENTERLITE#0) のいずれかでなければなりません。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-TargetUrl

ソース サイトが交換されるターゲット サイトの URL。 交換を実行する前に、この場所のサイトが存在している必要があります。

ターゲット サイトは次のいずれかである必要があります。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online