Create a device account using UI (Surface Hub)

If you prefer to use a graphical user interface, you can create a device account for your Microsoft Surface Hub with either the Office 365 UI or the Exchange Admin Center.

Create a device account using Office 365

  1. Create the account in the Microsoft 365 Admin Center.
  2. Create a mobile device mailbox (ActiveSync) policy from the Microsoft Exchange Admin Center.
  3. Use PowerShell to complete device account creation.
  4. Use PowerShell to configure Exchange properties of the account.
  5. Enable the account with Skype for Business.

Create the account in the admin center

  1. Sign in to Office 365 by visiting http://portal.office.com

  2. Provide the admin credentials for your Office 365 tenant. This will take you to your Microsoft 365 Admin Center.

    Microsoft 365 admin center.

  3. In the admin center, navigate to Resources in the left panel, and then click Rooms & equipment.

    Rooms & equipment option in admin center

  4. Click Add to create a new Room account. Enter a display name and email address for the account, and then click Add.

    Create new room account window

  5. Select the Room account you just created in the Active Users list. In the right panel, you can see the account properties and several optional actions. Click Reset password to change the password, and unselect Make this user change their password when they first sign in, because it is not possible to change the password from the Surface Hub sign-in flow.

  6. In the Assigned license section, click Edit, and then click the dropdown arrow next to the appropriate license to expand the details. Select a user location, and in the list of licenses, toggle on Skype for Business Online (Plan 2), and then click Save. The license may vary depending on your organization (for example, you might have Plan 2 or Plan 3).

Create a mobile device mailbox (ActiveSync) policy from the Exchange Admin Center

  1. In the admin center’s left panel, click ADMIN, and then click Exchange.

    admin center, showing exchange active users.

  2. This will open another tab on your browser to take you to the Exchange Admin Center, where you can create and set the Mailbox Setting for Surface Hub.

    Exchange admin center.

  3. To create a Mobile Device Mailbox Policy, click Mobile from the left panel and then click Mobile device mailbox policies. Surface Hubs require an account with a mobile device mailbox policy that does not require a password, so if you already have an existing policy that matches this requirement, you can apply that policy to the account. Otherwise use the following steps to create a new one to be used only for Surface Hub device accounts.

    Exchange admin center - creating a mobile device mailbox policy.

  4. To create a New Surface Hub mobile device mailbox policy, click the + button from the controls above the list of policies to add a new policy. For the name, provide a name that will help you distinguish this policy from other device accounts (for example, SurfaceHubDeviceMobilePolicy). Make sure the policy does not require a password for the devices assigned to, so make sure Require a Password remains unchecked, then click Save.

    Image showing new mobile device policy.

  5. After you have created the new mobile device mailbox policy, go back to the Exchange Admin Center and you will see the new policy listed.

    Image with new mobile device mailbox policy in Exchange admin center.

Use PowerShell to complete device account creation

From here on, you'll need to finish the account creation process using PowerShell to set up some configuration.

In order to run cmdlets used by these PowerShell scripts, the following must be installed for the admin PowerShell console:

Install the following module in Powershell

    install-module AzureAD
    Install-module MsOnline

Connecting to online services

  1. Run Windows PowerShell as Administrator.

    Image showing how to start Windows PowerShell and run as administrator.

  2. Create a Credentials object, then create a new session that connects to Skype for Business Online, and provide the global tenant administrator account, then click OK.

    Image for Windows PowerShell credential request.

  3. To connect to Microsoft Online Services, run:

    Connect-MsolService -Credential $Cred
    

    Image showing PowerShell cmdlet.

  4. Now to connect to Skype for Business Online Services, run:

    $sfbsession = New-CsOnlineSession -Credential $cred
    

    Image showing PowerShell cmdlet.

  5. Finally, to connect to Exchange Online Services, run:

    $exchangeSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri "https://outlook.office365.com/powershell-liveid/" -Credential $cred -Authentication "Basic" –AllowRedirection
    

    Image showing PowerShell cmdlet.

  6. Now you have to import the Skype for Business Online Session and the Exchange Online session you have just created, which will import the Exchange and Skype Commands so you can use them locally.

    Import-PSSession $exchangesession -AllowClobber -WarningAction SilentlyContinue
    Import-PSSession $sfbsession -AllowClobber -WarningAction SilentlyContinue
    

    Note that this could take a while to complete.

    Image showing PowerShell cmdlet.

  7. Once you’re connected to the online services you need to run a few more cmdlets to configure this account as a Surface Hub device account.

Use PowerShell to configure Exchange properties of the account

Now that you're connected to the online services, you can finish setting up the device account. You'll use the device account email address to:

  • Change the mailbox type from regular to room.
  • Set the password and enable the room mailbox account
  • Change various Exchange properties
  • Set the user account password to never expire.
  1. You’ll need to enter the account’s mail address and create a variable with that value:

    $mailbox = (Get-Mailbox <your device account’s alias>)
    

    To store the value get it from the mailbox:

    $strEmail = $mailbox.WindowsEmailAddress
    

    Print the value:

    $strEmail
    

    You will see the correct email address.

    Image showing PowerShell cmdlet.

  2. Run the following cmdlet:

    Set-CASMailbox $strEmail  -ActiveSyncMailboxPolicy "SurfaceHubDeviceMobilePolicy"
    
  3. Various Exchange properties can be set on the device account to improve the meeting experience. You can see which properties need to be set in the Exchange properties section.

    Set-CalendarProcessing -Identity $strEmail -AutomateProcessing AutoAccept -AddOrganizerToSubject $false –AllowConflicts   $false –DeleteComments $false -DeleteSubject $false -RemovePrivateProperty $false
    Set-CalendarProcessing -Identity $strEmail -AddAdditionalResponse $true -AdditionalResponse "This is a Surface Hub room!"
    

    Image showing PowerShell cmdlet.

  4. If you decide to have the password not expire, you can set that with PowerShell cmdlets too. See Password management for more information.

    Set-MsolUser -UserPrincipalName $strEmail -PasswordNeverExpires $True
    

Enable the account with Skype for Business

Enable the device account with Skype for Business.

In order to enable Skype for Business, your environment will need to meet the following prerequisites:

  • You'll need to have Skype for Business Online Standalone Plan 2 or higher in your O365 plan. The plan needs to support conferencing capability.
  • If you need Enterprise Voice (PSTN telephony) using telephony service providers for the Surface Hub, you need Skype for Business Online Standalone Plan 3.
  • Your tenant users must have Exchange mailboxes.
  • Your Surface Hub account does require a Skype for Business Online Standalone Plan 2 or Skype for Business Online Standalone Plan 3 license, but it does not require an Exchange Online license.
  1. Start by creating a remote PowerShell session from a PC.

    Import-Module SkypeOnlineConnector
    $cssess=New-CsOnlineSession -Credential $cred
    Import-PSSession $cssess -AllowClobber
    
  2. To enable your Surface Hub account for Skype for Business Server, run this cmdlet:

    Enable-CsMeetingRoom -Identity $strEmail -RegistrarPool "sippoolbl20a04.infra.lync.com" -SipAddressType EmailAddress
    

    If you aren't sure what value to use for the RegistrarPool parameter in your environment, you can get the value from an existing Skype for Business user using this cmdlet:

    Get-CsOnlineUser -Identity ‘alice@contoso.microsoft.com’| fl *registrarpool*
    

Create a device account using the Exchange Admin Center

Note

This method will only work if you are syncing from an on-premises Active Directory.

You can use the Exchange Admin Center to create a device account:

  1. Create an account and mailbox with the Exchange Admin Center.
  2. Create a mobile device mailbox policy from the Exchange Admin Center.
  3. Use PowerShell to configure the account.
  4. Enable the account with Skype for Business.

Create an account and mailbox with the Exchange Admin Center

  1. Sign in to your Exchange Admin Center using Exchange admin credentials.

  2. Once you are at the Exchange Admin Center (EAC), navigate to Recipients in the left panel.

    Image showing mailboxes in Exchange admin center.

  3. On the controls above the list of mailboxess, choose + to create a new one, and provide a Display name, Name, and User logon name, and then click Save.

    Image showing creating a new mailbox.

Create a mobile device mailbox policy from the Exchange Admin Center

Note

If you want to create and assign a policy to the account you created, and are using Exchange 2010, look up the corresponding information regarding policy creation and policy assignment when using the EMC (Exchange management console).

  1. Go to the Exchange Admin Center.

    Image showing Exchange admin center.

  2. To create a mobile device mailbox policy, click Mobile from the left panel, then Mobile device mailbox policies. Surface Hubs require an account with a mobile device mailbox policy that does not require a password, so if you already have an existing policy that matches this requirement, you can apply that policy to the account. Otherwise use the following steps to create a new one to be used only for Surface Hub device accounts.

    Image showing using Exchange admin center to create a mobile device mailbox policy.

  3. To create a new mobile device account mailbox policy, click the + button from the controls above the list of policies to add a new policy. For the name provide a name that will help you distinguish this policy from other device accounts (for example, SurfaceHubDeviceMobilePolicy). The policy must not be password-protected, so make sure Require a Password remains unchecked, then click Save.

    Image showing new mobile device mailbox policy.

  4. After you have created the new mobile device mailbox policy, go back to the Exchange Admin Center and you will see the new policy listed.

    Image showing new mobile device mailbox policy in Exchange admin center.

  5. To apply the ActiveSync policy without using PowerShell, you can do the following:

    • In the EAC, click Recipients > Mailboxes and select a mailbox.

      image showing exchange admin center.

    • In the Details pane, scroll to Phone and Voice Features and click View details to display the Mobile Device Details screen.

      image showing mailbox details.

    • The mobile device mailbox policy that’s currently assigned is displayed. To change the mobile device mailbox policy, click Browse.

      image showing the currently assigned mobile device mailbox policy.

    • Choose the appropriate mobile device mailbox policy from the list, click OK and then click Save.

      image showing list of mobile device mailbox policies.

Use PowerShell to configure the account

Now that you're connected to the online services, you can finish setting up the device account. You'll use the device account email address to:

  • Change the mailbox type from regular to room.
  • Change various Exchange properties
  • Set the user account password to never expire.
  1. You’ll need to enter the account’s mail address and create a variable with that value:

    $mailbox = (Get-Mailbox <your device account’s alias>)
    

    To store the value got it from the mailbox:

    $strEmail = $mailbox.WindowsEmailAddress
    

    Print the value by running:

    $strEmail
    

    You will see the correct email address.

  2. You need to convert the account into a room mailbox, so run:

    Set-Mailbox $strEmail -Type Room
    
  3. In order for the device account to be authenticated on a Surface Hub, you need to enable the room mailbox account and set a password, so the account can be used by the device to get meeting information using ActiveSync and log in to Skype for Business.

    Set-Mailbox $strEmail -RoomMailboxPassword (ConvertTo-SecureString  -String "<your password>" -AsPlainText -Force) -EnableRoomMailboxAccount $true
    
  4. Various Exchange properties can be set on the device account to improve the meeting experience. You can see which properties need to be set in the Exchange properties section.

    Set-CalendarProcessing -Identity $strEmail -AutomateProcessing AutoAccept -AddOrganizerToSubject $false –AllowConflicts   $false –DeleteComments $false -DeleteSubject $false -RemovePrivateProperty $false
    Set-CalendarProcessing -Identity $strEmail -AddAdditionalResponse $true -AdditionalResponse "This is a Surface Hub room!"
    
  5. Now we have to set some properties in AD. To do that, you need the alias of the account (this is the part of the UPN that becomes before the “@”).

    $strAlias = “<your device account’s alias>”
    
  6. The user needs to be enabled in AD before it can authenticate with a Surface Hub. Run:

    Set-ADUser $strAlias -Enabled $True
    
  7. If you decide to have the password not expire, you can set that with PowerShell cmdlets too. See Password management for more information.

    Set-ADUser $strAlias -PasswordNeverExpires $True
    

Enable the account with Skype for Business

Enable the device account with Skype for Business.

In order to enable Skype for Business, your environment will need to meet the following prerequisites:

  • You'll need to have Skype for Business Online Standalone Plan 2 or higher in your O365 plan. The plan needs to support conferencing capability.
  • If you need Enterprise Voice (PSTN telephony) using telephony service providers for the Surface Hub, you need Skype for Business Online Standalone Plan 3.
  • Your tenant users must have Exchange mailboxes.
  • Your Surface Hub account does require a Skype for Business Online Standalone Plan 2 or Skype for Business Online Standalone Plan 3 license, but it does not require an Exchange Online license.
  1. Start by creating a remote PowerShell session from a PC.

    Import-Module SkypeOnlineConnector
    $cssess=New-CsOnlineSession -Credential $cred
    Import-PSSession $cssess -AllowClobber
    
  2. Retrieve your Surface Hub account Registrar Pool

If you aren't sure what value to use for the RegistrarPool parameter in your environment, you can get the value from an existing Skype for Business user using this cmdlet:

```PowerShell
Get-CsOnlineUser -Identity ‘alice@contoso.microsoft.com’| fl *registrarpool*
```
  1. To enable your Surface Hub account for Skype for Business Server, run this cmdlet:

    Enable-CsMeetingRoom -Identity $strEmail -RegistrarPool "sippoolbl20a04.infra.lync.com" -SipAddressType EmailAddress