Search for a command to run...
Microsoft 365 Expert, Web3 Enthusiast, Jack-of-all-trades and exceptionally gifted Peter Pan. Passionate about digitalisation, collaboration, "boards" (from surf over chess up to monopoly) and Pizza.
No comments yet. Be the first to comment.
... and no one understands Enterprise Architecture. It's now a while since I am working in the information technology sector... almost 20 years to be more specific. During these years, I experienced many paradigm changes. With these paradigm changes,...
Modify Microsoft List Toolbar Buttons with List Formatting (JSON)
Whether you have overbooked yourself, realized you have a conflict, or otherwise can’t or don’t want to participate in a project, it’s essential to uncommit gracefully. Doing so will keep your reputation intact and your relationships strong. In case...
Microsoft currently offers two popular LCNC automation tools: Power Automate and Logic Apps. Both require no or low-code and can help streamline repetitive digital processes. The correct one for your scenario will depend largely on the use case you h...
In this article, I am going to explain you the importance of the root-site in SharePoint Online and how to use the PowerShell commands instead of the tempting button in the SharePoint Online Admin-Center.
If you are using SharePoint Online, you surely noticed in your SharePoint Online Admin-Center a Site-Collection under the URL https://[yourtenantname].sharepoint.com. That is the root-site. This root-site can be replaced either with a PowerShell command or a button in the Admin-Center.
Last week, a customer contacted me asking urgently for help. He told me (pretty exhausted) since some hours nobody of their M365-Users or guests was able to access any SharePoint Online Document Library (yep... MS-Teams was also affected) or OneDrive folder. The problem comes in a bad timing since they were changing their Intranet (which meant, they had to replace the root-site... and they did it with the button.
Actually, you should not be able to delete your SharePoint Online root site. In most cases, this is prohibited via the user interface. However, the customer who called me explained to me they used the "Change home site" button in the SharePoint Online Admin-Center and after that things became bad...
My guess: The root-site has been replaced by the admin more than once within minutes. Maybe he choose the wrong site and immediately re-initiated the process. This resulted in the script behind the button to not work properly.
⚠ If you don't have a root site, you are basically @#$% – all your other SharePoint sites, including everyone’s OneDrive, will stop working until you recover the site from the Recycle Bin or provision a new one (and that was what we had to do to solve the problem... just simply using PowerShell instead of the UI-button in SharePoint Admin-Center.)
In order to fix that, you need to use the following PowerShell Command:
Invoke-SPOSiteSwap
The SharePoint site collection at the Microsoft 365 tenant root typically occupies the preferred location for a company Intranet. Until some years ago the only way to apply some modern SharePoint functionality was to create a new SharePoint page and make it the Home Page for the site.
Invoke-SPOSiteSwap is a SharePoint Online PowerShell cmdlet that can be used to swap out your old classic SharePoint root site in your Microsoft 365 tenant and replace it with a shiny new Modern Communication Site (preferable), Modern Team Site or Classic team Site.
First of all ensure you have the latest SharePoint Online Management Shell installed (Link)
Run PowerShell (as an administrator) and login to SharePoint Online with the following command:
Connect-SPOService -Url https://[yourdomain]-admin.sharepoint.com
once you are connected, run the following command (in one line):
Invoke-SPOSiteSwap -SourceURL https://[yourdomain].sharepoint.com/sites/home -TargetURL https://yourdomain.sharepoint.com -ArchiveUrl https://yourdomain.sharepoint.com/sites/archivedhome
SourceURL — This is the new site that you want to swap with your old tenant classic root. If TargetURL is the tenant root then SourceURL must be an existing Modern Communication site, Modern Team Site or Classic Team Site.
TargetURL — This is your existing Classic root site in the Office 365 tenant (or existing Search Centre, not covered here)
ArchiveURL — location to archive existing root content.
Typically less than 5 minutes ! No content is actually being moved around so the size of your existing tenant root is not relevant here. Having said that the content is re-crawled after the move to rebuild the search index. That could take some time.
Source & target sites cannot be associated with an Office 365 Group or Hub site. If a Hub site association exists then remove this first and re-create after the swap process.
Featured Links will be lost in the process (displayed on SharePoint Home) so take note of these and re-create as required after the swap completes.
Note that currently the Classic Site Collection page will still list the tenant root site even though it’s now using a Communication site template.
You may get a 404 error in the browser if you try to access the root site during swap. Give it a few minutes.
Hope this helps. In my case, the customer was pretty relieved ;-).