diff --git a/devices/surface-hub/surface-hub-2s-configure-with-powershell.md b/devices/surface-hub/surface-hub-2s-configure-with-powershell.md index b1a608b075..e85f761781 100644 --- a/devices/surface-hub/surface-hub-2s-configure-with-powershell.md +++ b/devices/surface-hub/surface-hub-2s-configure-with-powershell.md @@ -10,5 +10,93 @@ audience: Admin ms.topic: article ms.localizationpriority: Normal --- +# Configure Surface Hub 2S accounts via PowerShell -# Configure Surface Hub 2S accounts via PowerShell \ No newline at end of file +## Connect to Exchange Online PowerShell + + ```PowerShell + $365Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell -Credential (Get-Credential) -Authentication Basic –AllowRedirection $ImportResults = Import-PSSession $365Session + ``` + +## Create a new Room Mailbox + + ```PowerShell +New-Mailbox -MicrosoftOnlineServicesID account@YourDomain.com -Alias SurfaceHub2S -Name SurfaceHub2S -Room -EnableRoomMailboxAccount $true -RoomMailboxPassword (ConvertTo-SecureString -String "" -AsPlainText -Force) +``` + +## Set Calendar Auto processing + ```PowerShell + Set-CalendarProcessing -Identity "account@YourDomain.com" -AutomateProcessing AutoAccept -AddOrganizerToSubject $false –AllowConflicts $false –DeleteComments $false -DeleteSubject $false -RemovePrivateProperty $false -AddAdditionalResponse $true -AdditionalResponse "This room is equipped with a Surface Hub" +``` +## Assign a license + +```PowerShell +Connect-MsolService +Set-Msoluser -UserPrincipalName account@YourDomain.com -UsageLocation IE +Set-MsolUserLicense -UserPrincipalName "account@YourDomain.com" -AddLicenses "contoso:MEETING_ROOM" +``` + +# Connecting to Skype for Business Online using PowerShell + +**Install prerequisites** + +- [Visual C++ 2017 Redistributable](https://aka.ms/vs/15/release/vc_redist.x64.exe) +- [Skype for Business Online PowerShell Module](https://www.microsoft.com/en-us/download/confirmation.aspx?id=39366) + +```PowerShell + Import-Module LyncOnlineConnector + $SfBSession = New-CsOnlineSession -Credential (Get-Credential) + Import-PSSession $SfBSession -AllowClobber + Enable the Skype for Business meeting room + Enable-CsMeetingRoom -Identity account@YourDomain.com -RegistrarPoo(Get-CsTenant).Registrarpool -SipAddressType EmailAddress +``` + +# Configuring on-premises accounts using PowerShell +## Connect to Exchange Server PowerShell + +> [!NOTE] +> It is important that you know the FQDN of the Client Access service of the on-premises Exchange server. + +```PowerShell + $ExchServer = Read-Host "Please Enter the FQDN of your Exchange Server" + $ExchSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://$ExchServer/PowerShell/ -Authentication Kerberos -Credential (Get-Credential) + Import-PSSession $ExchSession +``` + +## Create the device account + ```PowerShell +New-Mailbox -UserPrincipalName Hub01@contoso.com -Alias Hub01 -Name "Hub 01" -Room -EnableRoomMailboxAccount $true -RoomMailboxPassword (ConvertTo-SecureString -String -AsPlainText -Force) +``` + +## Set automatic calendar processing + ```PowerShell +Set-CalendarProcessing -Identity "HUB01@contoso.com" -AutomateProcessing AutoAccept -AddOrganizerToSubject $false –AllowConflicts $false –DeleteComments $false -DeleteSubject $false -RemovePrivateProperty $false -AddAdditionalResponse $true -AdditionalResponse "This room is equipped with a Surface Hub" + ``` + +## Enable the Skype for Business object + +> [!NOTE] +> It is important that you know the FQDN of the Skype for Business Registrar Pool. + + +```PowerShell +Enable-CsMeetingRoom -Identity Contoso\HUB01 -SipAddressType emailaddress -RegistrarPool SfbIEFE01.contoso.local +``` + +# Mobile Device Mailbox Policy + +You may need to create a new Mobile Device Mailbox Policy (also known as ActiveSync Policy) to allow your Surface Hub to connect to your online or on-premises environment. + + +## Create a Surface Hub mobile device mailbox policy +```PowerShell +New-MobileDeviceMailboxPolicy -Name “Surface Hubs” -PasswordEnabled $false +``` + +## Additional settings + +It is recommended to add a MailTip to Surface Hub rooms so users remember to make the meeting a Skype for Business or Teams meeting: + +```PowerShell +Set-Mailbox "Surface Hub 2S" -MailTip "This is a Surface Hub room. Please make sure this is a Microsoft Teams meeting." +``` diff --git a/devices/surface-hub/surface-hub-2s-connect.md b/devices/surface-hub/surface-hub-2s-connect.md index 038df389ce..31601d4429 100644 --- a/devices/surface-hub/surface-hub-2s-connect.md +++ b/devices/surface-hub/surface-hub-2s-connect.md @@ -80,7 +80,7 @@ You can connect the following accessories to Surface Hub-2S using Bluetooth: - Headsets - Speakers -NOTE: After you connect a Bluetooth headset or speaker, you might need to change the default microphone and speaker settings. For more information, refer to [Local management for Surface Hub settings](https://docs.microsoft.com/en-us/surface-hub/local-management-surface-hub-settings). +NOTE: After you connect a Bluetooth headset or speaker, you might need to change the default microphone and speaker settings. For more information, refer to [Local management for Surface Hub settings](https://docs.microsoft.com/surface-hub/local-management-surface-hub-settings). # Learn more diff --git a/devices/surface-hub/surface-hub-2s-deploy.md b/devices/surface-hub/surface-hub-2s-deploy.md index a61919e8aa..b2057ca249 100644 --- a/devices/surface-hub/surface-hub-2s-deploy.md +++ b/devices/surface-hub/surface-hub-2s-deploy.md @@ -11,4 +11,48 @@ ms.topic: article ms.localizationpriority: Normal --- -# Deploy Surface Hub 2S \ No newline at end of file +# Deploy Surface Hub 2S + +## Deploy Surface Hub 2S with a provisioning package + +You can use Windows Configuration Designer (WCD) to create provisioning packages to automate the deployment process of Surface Hub 2S. Use provisioning packages to add certificates, configure proxies, set up device administrators and device accounts. You can also use provisioning packages in conjunction with a configuration file to deploy multiple Surface Hubs with a single USB thumb drive. + +### Install Windows Configuration Designer +Install Windows Configuration Designer from the Windows Assessment and Deployment Kit (ADK) for Windows 10. Download and install the ADK for Windows 10, version 1703. + +### Add certificates +You can import Certificate Authority certificates to Surface Hub 2S. +To add certificates to Surface Hub 2S, you’ll need a copy of each certificate as X.509 in .cer format. You cannot import .crt, .pfx or other container formats. +Certificates must be imported into Windows Configuration Designer and arranged by hierarchy: + + ![Add certificates](images/sh2-wcd.png) + + +### Configure proxy during OOBE +In Windows Configuration Designer, go to the Configure proxy settings tab and enter the appropriate settings as shown below. + + ![Configure proxy settings](images/sh2-proxy.png) + +> **[*!NOTE*] +> **When configuring proxy settings, turn off **Automatically detect settings** if you intend to use a setup script or a proxy server. You can use a setup script *or* a proxy server, not both. + +### Affiliate Surface Hub 2S with Azure Active Directory +You can affiliate Surface Hub 2S with Azure Active Directory using a provisioning package: +As an Azure Active Directory Global Administrator, you can join large numbers of new Windows devices to Azure Active Directory and Intune using a bulk token. + +To create a bulk token, give it a friendly name, configure the expiration date (maximum of 30 days) and use your Admin credentials to acquire the token as shown below: + + ![Set up device admins](images/sh2-token.png)
+ ![Set up device admins](images/sh2-token2.png)
+ ![Set up device admins](images/sh2-token3.png)
+ +### Provisioning multiple devices (.csv file) +In addition to the provisioning package, you can use a Surface Hub configuration file to make it even easier to set up your devices. A Surface Hub configuration file contains a list of device accounts and friendly names for wireless projection. During first run, you’ll get an option to choose a device account and friendly name from a configuration file. + +### To create a Surface Hub configuration file + +1. Using Microsoft Excel or another CSV editor, create a CSV file named: **SurfaceHubConfiguration.csv** +2. Enter a list of device accounts and friendly names in this format: **,,** +3. Save the file to the root of the USB thumb drive where you copied the PPKG file. + + ![Configuration file example](images/sh2-config-file.png)