Introduction
You can have multiple Workspace environments within your instance. We offer a tool based on powershell you can use to create a new environment. This article explains how this works.
Important:
The default module for Workspace environments created in 2024 will be set to Engage. For more information, please refer to the Billing section.
Want to create a demo environment? See Creating a demo environment.
Provisioning key
The provisioning key of your instance, given when you started as a partner, is required to create an environment. With this key you can manage your entire instance, e.g. create or delete environments. It is highly sensitive information and should be known in your organization.
Important:
Hosted partners are responsible for storing their own provisioning key in a secure location. Workspace 365 does not store partners' provisioning keys and cannot supply or verify existing keys. If you have lost your provisioning key, refer to Request new provisioning key.
Self-hosted partners can find the $provisioningKey in:
\inetpub\wwwroot\Workspace 365\Workspace 365\Configs\NDAW.Html.Front.config
Prerequisites
Download the create environment tool
Always make sure to use the latest version. Follow the Latest Announcements to be notified when a new version becomes available
Make sure that the corresponding Azure tenant exists at least 24 hours
You need an Azure Global administrator account to create a Workspace environment
The Azure Global administrator must have a first name and last name in Azure
We strongly recommend to use a shared account and to retain access to this account
We strongly recommend having at least 1 admin in the environment with a valid Exchange license for Request Emergency Admin Access, but creating an environment does not require an Exchange license
Instructions
If you run into issues with the tool, refer to Create new environment errors & solutions.
After downloading the tool, unzip the ZIP file.
You may need to unblock the .exe file after downloading
Make sure to keep both the executable & MSAL.PS in the same (local) folder. Otherwise the script won't work.
Run CreateWorkspaceEnvironment.exe
In a browser, go to https://microsoft.com/devicelogin and use the provided code to authenticate.
Use the Global Admin account to sign in to the Microsoft Azure powershell application on your device.
Once signed in, fill in the hostname of your instance without quotation marks, e.g. https://yourcompany.workspace365.net.
The hostname of your instance should be known in your organization.
Enter the provisioning key.
The tool will offer to save the provided hostname and provisioning key to a configuration file. We recommend doing this to make future deployments faster.
Enter the desired environment name.
The tool will now deploy the new environment.
Once finished, navigate to the displayed URL to sign in to your newly created Workspace environment.