Install the Microsoft StaffHub PowerShell module

Important

Effective October 1, 2019, Microsoft StaffHub will be retired. We’re building StaffHub capabilities into Microsoft Teams. Today, Teams includes the Shifts app for schedule management and additional capabilities will roll out over time. StaffHub will stop working for all users on October 1, 2019. Anyone who tries to open StaffHub will be shown a message directing them to download Teams. To learn more, see Microsoft StaffHub to be retired.

Use the steps in this article to install and connect to the Microsoft StaffHub PowerShell module. You'll need this to manage StaffHub by using PowerShell and to move your StaffHub teams to Microsoft Teams.

Install the Microsoft StaffHub PowerShell module

  1. Open Windows PowerShell 3.0 or later as an admin. To do this, click Start, type Windows PowerShell, right-click Windows PowerShell, and then select Run as administrator.

    Note

    To get the latest version of Windows PowerShell, see Installing Windows PowerShell.

  2. Run the following to install the current stable version of the StaffHub PowerShell module:

    Install-Module -Name MicrosoftStaffHub
    

    You can run this command only if you need to install the latest version, which may have more instabilities than the current stable version: Install-Module -Name MicrosoftStaffHub -AllowPrerelease

    Note

    If you receive an error during the installation of the latest version with more instabilities, you can run: Install-Module PowershellGet -Force

  3. You may see the warning message:

    Untrusted repository - You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from 'PSGallery'?
    

Type Y and click Enter.

  1. Exit Windows PowerShell.

Connect to the Microsoft StaffHub PowerShell module

  1. Run the following:

    Connect-StaffHub
    
  2. When you're prompted, log in as a global admin.