Add SharePoint Site Collection with Microsoft 365

This article provides Administrators with instructions to configure a new SharePoint Online site collection for an existing Appspace Intranet installation.

Prerequisites

• Ensure Appspace Intranet version 4.14 or later is installed on your Microsoft 365 tenant.

Microsoft 365 Specific Requirements

• Ensure Azure CLI version 2.56 or later is installed. Installation link: https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-windows?tabs=azure-cli
  Note

  You may execute the following PowerShell command to verify your Azure CLI version:

  az version

• Ensure the following Roles and Permissions have been configured:
  • SharePoint Administrator – This role within the Azure Microsoft 365 subscription is required to create the new Sharepoint Online site collection.
  • Appspace Intranet Administrator – This is a SharePoint Site Collection Administrator assigned as an Appspace Intranet Administrator, is required to add the site collection to the Appspace Intranet configuration.

Create and Configure a SharePoint Online Site Collection

This section is to be performed by the SharePoint Administrator.

Create and configure the SharePoint site collection by using the Team site (classic experience) template as per the instructions outlined in the Create a site article by Microsoft.

Enable Custom Scripts

To enable the provisioning of CSS and JS files, pages, layouts, and images during installation, it’s essential to allow custom scripts for the new site collection. This involves enabling custom scripts on the newly created site collection, by following the instructions outlined in the Manage Custom Script from SharePoint Admin Center section within this Microsoft article.

Execute Install Script

This section is to be performed by the Appspace Intranet Administrator.

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

Executing this script provisions all required files to the new SharePoint site collection, and updates the existing Appspace Intranet configuration.

1. Download and extract the contents of the installation package to your local folder.
2. Browse and navigate to the “Install/Deployment Files” folder path.
3. Launch the PowerShell console, and execute the following script to save the Microsoft Entra ID app configuration as a CSV file, that is required to authenticate the account and connect to the Intranet API.

   PS > .\GetEntraIDAppConfigCsv.ps1

   

   
   Parameters:
   • EntraIDAppName (optional): Name of the Intranet Microsoft Entra ID app. Only needed if you changed the default “BeezyM365” name or want to get another one.
   • AppServiceCustomDomainUrl (optional): Public App Service URL. Only needed if you have a custom domain (URL different than https://*.azurewebsites.net).
4. Execute the following script to start the job to provision the required files and add the site collection to the Intranet instance:

   PS > .\InstallSiteCollection.ps1 -SiteCollectionUrl https://mytenant.sharepoint.com/sites/secondsc -EntraIDAppConfigCsvPath BeezyAzureADAppConfig.csv

   
    

   
   Parameters:
   • SiteCollectionUrl (mandatory): URL of the new site collection created in the previous step.
   • EntraIDAppConfigCsvPath (mandatory): relative or absolute path where you have the CSV file with the Microsoft Entra ID app configuration data (generated in the previous step).
5. Once the executed job has been completed successfully, you may browse the URL of the new Sharepoint site collection to access the Appspace Intranet. Alternatively, navigate to “Intranet settings > Manage site collections” to view all Sharepoint sites within the instance.