Freigeben über

Invoke-SPOSiteSwap

  • Referenz
Modul:
Microsoft.Online.SharePoint.PowerShell
Gilt für::
SharePoint Online

Ruft einen Auftrag zum Austauschen des Standorts einer Website mit einer anderen Website auf, wobei die ursprüngliche Website archiviert wird.

Syntax

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

Beschreibung

Tauscht den Speicherort einer Quellwebsite mit einer Zielwebsite aus, wobei die ursprüngliche Zielwebsite archiviert wird.

Beachten Sie, dass es sich bei der Zielwebsite um Folgendes handeln muss:

Beim Initiieren des Tauschs wird die Zielwebsite an den Archivspeicherort verschoben und die Quellwebsite wird an den Zielort verschoben. Standardmäßig wird eine Website-Umleitung am Quellspeicherort erstellt, um den Datenverkehr an den Zielspeicherort umzuleiten.

Wenn es sich bei dem Ziel um die Stammwebsite auf https://tenant-name.sharepoint.com handelt, dann sollten die folgenden Vorbereitungsaktivitäten vor der Durchführung des Tauschs durchgeführt werden:

  1. Alle in der SharePoint-Startseite auf https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx definierten Links werden nach der Durchführung des Tauschs nicht angezeigt. Bei Bedarf sollten die empfohlenen Links dokumentiert werden, damit Sie nach dem Tausch manuell neu erstellt werden können.
  2. Funktionen wie externe Freigabe und Anwendungsschnittstellen sind von den Richtlinien und Berechtigungen abhängig, die auf der Stammwebsite definiert sind. Überprüfen Sie die Quellwebsite, um sicherzustellen, dass sie über die erforderlichen Richtlinien und Berechtigungen gemäß der vorhandenen Stammwebsite verfügt. Dazu gehören Einstellungen für die externe Freigabe sowie Websiteberechtigungen.
  3. Größere Mandanten mit mehr als ~10.000 Lizenzen müssen das Seitendiagnosetool für den Quellstandort ausführen (stellen Sie sicher, dass der Benutzer, der das Seitendiagnosetool ausführt, über Bearbeitungsrechte am Quellstandort verfügt). Alle Analyseergebnisse mit der Kategorie "Handlungsbedarf (rot)" oder "Verbesserungsmöglichkeiten (orange)“ müssen vor der Durchführung des Tauschs behoben werden.

Die Quell- und Zielwebsites können nicht mit einer Office 365-Gruppe verbunden werden. Sie können auch keine Hubwebsites sein oder einem Hub zugeordnet sein. Wenn es sich bei einer Website um eine Hubwebsite handelt, heben Sie die Registrierung als Hubwebsite auf, tauschen Sie die Stammwebsite und registrieren Sie die Website dann als Hubwebsite. Wenn eine Website einem Hub zugeordnet ist, heben Sie die Zuordnung zur Website auf, tauschen Sie die Stammwebsite und ordnen Sie die Website dann erneut zu.

Wenn das Veröffentlichungsfeature zuvor aktiviert wurde oder derzeit auf der Quell-Website aktiviert ist, kann Invoke-SPOSiteSwap nicht verwendet werden.

Beispiele

BEISPIEL 1

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

Archiviert die vorhandene Website unter https://contoso.sharepoint.com in https://contoso.sharepoint.com/sites/Archive und verschiebt https://contoso.sharepoint.com/sites/CommunicationSite nach https://contoso.sharepoint.com. Eine Website-Umleitung wird bei https://contoso.sharepoint.com/sites/CommunicationSite erstellt, die alle Anfragen an https://contoso.sharepoint.com. umleitet

BEISPIEL 2

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

Archiviert die vorhandene Suchcenter-Website unter https://contoso.sharepoint.com/search in https://contoso.sharepoint.com/sites/Archive und verschiebt https://contoso.sharepoint.com/sites/SearchSite nach https://contoso.sharepoint.com/search. Eine Website-Umleitung wird bei https://contoso.sharepoint.com/sites/SearchSite erstellt, die alle Anfragen an https://contoso.sharepoint.com/search. umleitet

BEISPIEL 3

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -DisableRedirection

Archiviert die vorhandene Website unter https://contoso.sharepoint.com in https://contoso.sharepoint.com/sites/Archive und verschiebt https://contoso.sharepoint.com/sites/CommunicationSite nach https://contoso.sharepoint.com. Keine Website-Umleitung wird bei https://contoso.sharepoint.com/sites/CommunicationSite. erstellt

BEISPIEL 4

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -Force

Archiviert die vorhandene Suchcenter-Website unter https://contoso.sharepoint.com/search in https://contoso.sharepoint.com/sites/Archive und verschiebt https://contoso.sharepoint.com/sites/SearchSite nach https://contoso.sharepoint.com/search. Eine Website-Umleitung wird bei https://contoso.sharepoint.com/sites/SearchSite erstellt, die alle Anforderungen an https://contoso.sharepoint.com/search. leitet Alle durch das Seitendiagnosetool benannten Warnungen werden ignoriert und der Tausch wird initiiert. Allerdings verhindern alle durch das Seitendiagnosetool festgestellte Fehler weiterhin die Initiierung des Tauschs.

Parameter

-ArchiveUrl

Die URL, auf der die Zielwebsite archiviert wird. Es sollte keine Website, einschließlich einer gelöschten Website, im Papierkorb an diesem Speicherort vorhanden sein, bevor Sie den Tausch durchführen.

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

-DisableRedirection

Deaktiviert die Erstellung der Website-Umleitung am Speicherort der Quell-URL.

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

-Force

All Warnungen, die durch das Seitendiagnosetool erkannt wurden, die die Initiierung eines Tausch verhinder, werden außer kraft gesetzt und ignoriert.

Wenn Sie beispielsweise die Warnung "Invoke-SPOSiteSwap : Errors: 0; Warnungen: 1; Details: 2 Elemente befinden sich nicht im CDN, bitte aktivieren Sie CDN." Warnungen können mit diesem Parameter außer Kraft gesetzt werden, aber die Elemente sollten auf langfristige Stabilität und Leistung überprüft und aufgelöst werden.

Alle durch das Seitendiagnosetool festgestellte Fehler verhindern weiterhin und unabhängig von diesem Parameter die Initiierung eines Tauschs.

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

-NoWait

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

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

-SourceUrl

Die URL der Quellwebsite. Die Website an diesem Speicherort muss vorhanden sein, bevor der Tausch durchgeführt wird.

Wenn das Ziel die Stamm-Website auf https://tenant-name.sharepoint.com ist, muss die Quell-Website entweder eine moderne Team-Website (STS#3) oder eine Kommunikations-Site (SITEPAGEPUBLISHING#0) sein, und das Veröffentlichungsfeature kann niemals auf der Quell-Website aktiviert worden sein.

Wenn es sich bei dem Ziel um die Suchcenter-Website auf https://tenant-name.sharepoint.com/search handelt, dann muss es sich bei der Quellwebsite um eine Suchcenter-Website (SRCHCEN # 0) oder eine einfache Suchcenter-Website (SRCHCENTERLITE # 0) handeln.

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

-TargetUrl

Die URL der Zielwebsite, an die die Quellwebsite getauscht wird. Die Website an diesem Speicherort muss vorhanden sein, bevor der Tausch durchgeführt wird.

Die Zielwebsite muss eins von Beiden sein:

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