Skip to main content
How do I create a Workspace environment?
Updated over a week ago

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

  • You need our tool to create environments, partners can download this from the Support Widget under Downloads > Tool for new Workspace environment

    • Always make sure to use the latest version

  • 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.

  1. After downloading the tool, unzip the ZIP file.

    • You may need to unblock the .exe file after downloading

  2. Make sure to keep both the executable & MSAL.PS in the same (local) folder. Otherwise the script won't work.

  3. Run CreateWorkspaceEnvironment.exe

  4. In a browser, go to https://microsoft.com/devicelogin and use the provided code to authenticate.

  5. Use the Global Admin account to sign in to the Microsoft Azure powershell application on your device.

  6. 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.

  7. Enter the provisioning key.

  8. 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.

  9. Enter the desired environment name.

  10. The tool will now deploy the new environment.

  11. Once finished, navigate to the displayed URL to sign in to your newly created Workspace environment.

Did this answer your question?