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.
Prerequisites:
Download the latest version of the PowerShell script to create a new Workspace environment. This download is only accessible trough our partner portal.
Or check on our partner portal the Support Widget section help > Downloads > Tool for new Workspace environment
Always make sure to use the latest version
For creating an environment: 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
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.WebApp.config
Instructions
Using the tool (both creating and deleting)
The first five steps are identical for both creating and deleting an environment.
Download the Create & Delete Script
Go to the Partner Portal.
Click on the pink Workspace logo in the bottom right corner.
Navigate to "Help" > "Get started with Workspace 365" > "Create or delete Workspace 365 environments".
Click on "Create & delete environments script".
Download the tool under the "Prerequisites" section.
Open the Script in PowerShell
Launch PowerShell and open the downloaded script.
First, enter the hostname of your instance (e.g., https://yourcompany.workspace365.net).
Enter a Reference Name (You can choose a name yourself. Under this name, you can save your data (step 5))
Provide a reference name to proceed.
Enter the Provisioning Key
Enter the Provisioning Key to continue.
Save the Data
Type "y" and press Enter.
This ensures that the entered data is saved, so you do not have to input it again.
The screenshot below shows step 2 until 5:
For creating an environment:
After the five aforementioned steps:
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.
Enter the desired environment name (see screenshot below).
The tool will now deploy the new environment.
Once finished, navigate to the displayed URL to sign in to your newly created Workspace environment.
For deleting an environment:
After the five steps under ‘Using the tool’:
Select an Existing Environment
Type "2" and press Enter (see screenshot below)
A list of available environments will appear.
Select the environment you want to delete and click "OK".
Confirm the Deletion
Choose option 5 'delete'
Enter the name of the environment you selected to confirm the deletion.
Note: Once you enter the name and confirm, the environment will be immediately deleted.
Important Notes
Ensure you select the correct environment before deleting it.
Once deleted, an environment can only be restored by Workspace 365