diff --git a/devices/surface-hub/TOC.md b/devices/surface-hub/TOC.md index a9cde81f15..742423081c 100644 --- a/devices/surface-hub/TOC.md +++ b/devices/surface-hub/TOC.md @@ -8,6 +8,7 @@ ##### [On-premises deployment (single forest)](on-premises-deployment-surface-hub-device-accounts.md) ##### [On-premises deployment (multiple forests)](on-premises-deployment-surface-hub-multi-forest.md) ##### [Hybrid deployment](hybrid-deployment-surface-hub-device-accounts.md) +##### [Online or hybrid deployment using Skype Hybrid Voice environment](skype-hybrid-voice.md) ##### [Create a device account using UI](create-a-device-account-using-office-365.md) ##### [Microsoft Exchange properties](exchange-properties-for-surface-hub-device-accounts.md) ##### [Applying ActiveSync policies to device accounts](apply-activesync-policies-for-surface-hub-device-accounts.md) diff --git a/devices/surface-hub/change-history-surface-hub.md b/devices/surface-hub/change-history-surface-hub.md index 74ee57c2f5..c4e63c63c4 100644 --- a/devices/surface-hub/change-history-surface-hub.md +++ b/devices/surface-hub/change-history-surface-hub.md @@ -14,6 +14,12 @@ localizationpriority: medium This topic lists new and updated topics in the [Surface Hub Admin Guide]( surface-hub-administrators-guide.md). +## April 2017 + +| New or changed topic | Description | +| --- | --- | +| [Online or hybrid deployment using Skype Hybrid Voice environment](skype-hybrid-voice.md) | New | + ## February 2017 | New or changed topic | Description | diff --git a/devices/surface-hub/create-and-test-a-device-account-surface-hub.md b/devices/surface-hub/create-and-test-a-device-account-surface-hub.md index b06c909230..3223d5d81b 100644 --- a/devices/surface-hub/create-and-test-a-device-account-surface-hub.md +++ b/devices/surface-hub/create-and-test-a-device-account-surface-hub.md @@ -49,6 +49,7 @@ For detailed steps using PowerShell to provision a device account, choose an opt | [On-premises deployment (single-forest)](on-premises-deployment-surface-hub-device-accounts.md) | Your organization has servers that it controls and uses to host Active Directory, Exchange, and Skype for Business (or Lync) in a single-forest environment. | | [On-premises deployment (multiple forests)](on-premises-deployment-surface-hub-multi-forest.md) | Your organization has servers that it controls and uses to host Active Directory, Exchange, and Skype for Business (or Lync) in a multi-forest environment. | | [Hybrid deployment](hybrid-deployment-surface-hub-device-accounts.md) | Your organization has a mix of services, with some hosted on-premises and some hosted online through Office 365. | +| [Online or hybrid deployment using Skype Hybrid Voice environment](skype-hybrid-voice.md) | Your organization has Skype for Business home pools and Exchange servers in the cloud, and uses an on-premises pool of Skype for Business 2015 or Cloud Connector edition connected via Public Switched Telephone Network (PSTN). | If you prefer to use a graphical user interface (UI), some steps can be done using UI instead of PowerShell. diff --git a/devices/surface-hub/images/adjust-room-audio.png b/devices/surface-hub/images/adjust-room-audio.png new file mode 100644 index 0000000000..3d0eef5ed7 Binary files /dev/null and b/devices/surface-hub/images/adjust-room-audio.png differ diff --git a/devices/surface-hub/images/new-user-hybrid-voice.png b/devices/surface-hub/images/new-user-hybrid-voice.png new file mode 100644 index 0000000000..e291f9ebca Binary files /dev/null and b/devices/surface-hub/images/new-user-hybrid-voice.png differ diff --git a/devices/surface-hub/images/new-user-password-hybrid-voice.png b/devices/surface-hub/images/new-user-password-hybrid-voice.png new file mode 100644 index 0000000000..1ae4d5560b Binary files /dev/null and b/devices/surface-hub/images/new-user-password-hybrid-voice.png differ diff --git a/devices/surface-hub/images/product-license-hybrid-voice.png b/devices/surface-hub/images/product-license-hybrid-voice.png new file mode 100644 index 0000000000..3d16aeb467 Binary files /dev/null and b/devices/surface-hub/images/product-license-hybrid-voice.png differ diff --git a/devices/surface-hub/images/select-room-hybrid-voice.png b/devices/surface-hub/images/select-room-hybrid-voice.png new file mode 100644 index 0000000000..961f8355e8 Binary files /dev/null and b/devices/surface-hub/images/select-room-hybrid-voice.png differ diff --git a/devices/surface-hub/skype-hybrid-voice.md b/devices/surface-hub/skype-hybrid-voice.md new file mode 100644 index 0000000000..d4b298f0fa --- /dev/null +++ b/devices/surface-hub/skype-hybrid-voice.md @@ -0,0 +1,101 @@ +--- +title: Online or hybrid deployment using Skype Hybrid Voice environment (Surface Hub) +description: This topic explains how to enable Skype for Business Cloud PBX with on premises PSTN connectivity via Cloud Connector Edition or Skype for Business 2015 pool. +keywords: hybrid deployment, Skype Hybrid Voice +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: surfacehub +author: jdeckerMS +localizationpriority: medium +--- + +# Online or hybrid deployment using Skype Hybrid Voice environment (Surface Hub) + +This topic explains how to enable Skype for Business Cloud PBX with on premises PSTN connectivity via Cloud Connector Edition or Skype for Business 2015 pool. In this option your Skype for Business home pools and Exchange servers are in the Cloud, however PSTN connected via on premises pool of Skype for Business 2015 or via a Cloud Connector edition. More about different Cloud PBX options is here https://technet.microsoft.com/en-us/library/mt612869.aspx + +If you deployed Skype for Business Cloud PBX with one of the hybrid voice options, please follow the steps below to enable the room account. It is important to create a regular user account first, assign all hybrid voice options and phone numbers and only after this convert the account to a room account. If you do not follow this order you will not be able to assign a hybrid phone number. + +>[!WARNING] +>If you created an account before without configuration of Hybrid voice (you run Enable-CSMeetingRoom command) you will not be able to configure required hybrid voice parameters. In order to configure hybrid voice parameters, for previously configured account or reconfiguring a phone number please delete and assign E5 or E3 + Cloud PBX add-on license again. After you reassigned the license, please start from step “Configure Hybrid Voice and Test” + +1. Create a new user account for Surface Hub. In this example, I will use surfacehub2@adatum.com account. The account can be created in local active directory and synchronized to the cloud or created directly in the cloud. + + ![new object user](images/new-user-hybrid-voice.png) + +2. Select “Password Never Expires” Note this is important for a Surface Room Device. + + ![Password never expires](images/new-user-password-hybrid-voice.png) + +3. In Office 365 add E5 license or E3 and Cloud PBX add-on to the user account created for the room. This is required for Hybrid Voice to work. + +![Add product license](images/product-license-hybrid-voice.png) + +4. Wait approximately 15 minutes until your user account appears in Skype for Business Online. + +5. Once your user is created in SfB online, enable it for Hybrid voice in Skype for Business Remote PowerShell + + ``` + Set-csuser surfacehub2@adatum.biz EnterpriseVoiceEnabled $true -HostedVocieMail $true -onpremlineuri tel:+15005000102 + ``` + +6. Validate Hybrid Voice call flow by placing test calls + +7. Start a remote PowerShell session on a PC and connect to Exchange. + + ``` + Set-ExecutionPolicy Unrestricted + $cred=Get-Credential -Message "Please use your Office 365 admin credentials" + $sess= New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/ps1-liveid/ -Credential $cred -Authentication Basic -AllowRedirection + Import-PSSession $sess + ``` + +8. After establishing a session, modify the mailbox account on previous steps and enable it as a RoomMailboxAccount. This allows the account to authenticate with Surface Hub. + + ``` + Set-Mailbox surfacehub2@adatum.biz -Type Room + Set-Mailbox surfacehub2@adatum.biz -EnableRoomMailboxAccount $true -RoomMailboxPassword (ConvertTo-SecureString -String -AsPlainText -Force) + ``` + +9. After setting up the mailbox, you will need to either create a new Exchange ActiveSync policy, or use a compatible existing policy. +Surface Hubs are only compatible with device accounts that have an ActiveSync policy where the PasswordEnabled property is set to False. If this isn’t set properly, then Exchange services on the Surface Hub (mail, calendar, and joining meetings), will not be enabled. +If you haven’t created a compatible policy yet, use the following cmdlet—this one creates a policy called "Surface Hubs". Once it’s created, you can apply the same policy to other device accounts. + + ``` + $easPolicy = New-MobileDeviceMailboxPolicy -Name “SurfaceHubs” -PasswordEnabled $false + ``` + + Once you have a compatible policy, then you will need to apply the policy to the device account. However, policies can only be applied to user accounts and not resource mailboxes. You need to convert the mailbox into a user type, apply the policy, and then convert it back into a mailbox—you may need to re-enable it and set the password again too. + + ``` + Set-Mailbox surfacehub2@adatum.biz -Type Regular + Set-CASMailbox surfacehub2@adatum.biz -ActiveSyncMailboxPolicy $easPolicy.id + Set-Mailbox surfacehub2@adatum.biz -Type Room + $credNewAccount = Get-Credential -Message "Please provide the Surface Hub username and password" + Set-Mailbox surfacehub2@adatum.biz -RoomMailboxPassword $credNewAccount.Password -EnableRoomMailboxAccount $true + ``` + +10. Various Exchange properties must 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 surfacehub2@adatum.biz -AutomateProcessing AutoAccept -AddOrganizerToSubject $false –AllowConflicts $false –DeleteComments $false -DeleteSubject $false -RemovePrivateProperty $false + Set-CalendarProcessing surfacehub2@adatum.biz -AddAdditionalResponse $true -AdditionalResponse "This is a Surface Hub room!" + ``` + +11. Enable the mailbox as a meeting device in Skype for Business Online. The first step is to understand your home registrar, to get the registrar pool. The second step is to run cmdlet which enables the acount as a meeting device (you need registrarpool with from the first cmdlet) + + ``` + Get-CsTenant | select registrarpool + Enable-CsMeetingRoom surfacehub2@adatum.biz -RegistrarPool 'sippoolbl20a04.infra.lync.com' -SipAddressType UserPrincipalName + ``` + + By running this cmdlet we will add a behavior when end user will be asked if he/she in a meeting room and if answer yes will mute mic and speaker + + ![](images/adjust-room-audio.png) + + It also will change lobby behavior, you can read about lobby behavior. + +At this moment the room account is fully configured, including Hybrid Voice. Note additional attributes, like description, location etc must be set in on premises as we sync the room from on premises. If you create a room in online these parameters can be set online. On the screenshot below you can see how end user sees the device. + + +![](images/select-room-hybrid-voice.png) \ No newline at end of file