Manage Microsoft Teams settings on Surface Hub

Article
02/15/2023

You can manage Microsoft Teams settings on a Surface Hub using Windows Configuration Designer or Microsoft Intune in Microsoft Endpoint Manager. Knowledge of Windows Configuration Designer or Microsoft Intune is required to make changes to Teams settings. For more information about these options, see the following articles:

Windows Configuration Designer is a good option if you only have a few Surface Hub devices and you can access them easily. If you have many Surface Hubs, or if they're in remote locations, use Microsoft Intune in Microsoft Endpoint Manager if it's deployed in your organization. Regardless of the method you choose, you need to create an XML configuration file to make changes to Teams settings on Surface Hub.

Teams configuration file syntax

Teams configuration on a Surface Hub is defined using an XML file. The XML file contains all the settings that can be used to control how Teams works. Both Windows Configuration Designer and Microsoft Intune use the same XML syntax. Here's an example of the Teams configuration XML file:

<SurfaceHubSettings>
    <BluetoothAdvertisementEnabled>true</BluetoothAdvertisementEnabled>
    <AutoAcceptProximateMeetingInvitations>true</AutoAcceptProximateMeetingInvitations>
    <CoordinatedMeetings enabled="true"> 
        <TrustedAccounts>room@contoso.com</TrustedAccounts>
        <Settings> 
            <Audio default="false" enabled="false" />
            <Video default="false" enabled="true" /> 
        </Settings> 
    </CoordinatedMeetings>
</SurfaceHubSettings>

The following table describes all the configuration settings available in the configuration file:

Parent	Element	Attribute	Description
None	`<SurfaceHubSettings>`		Contains all configuration elements for Teams configuration on a Surface Hub.
`<SurfaceHubSettings>`	`<BluetoothAdvertisementEnabled>`		Determines whether Surface Hub advertises that it's available for Bluetooth connections. Accepted values: `true`, `false`
`<SurfaceHubSettings>`	`<AutoAcceptProximateMeetingInvitations>`		Determines whether Teams will automatically accept proximity-based meetings. Accepted values: `true`, `false`
`<SurfaceHubSettings>`	`<CoordinatedMeetings>`		Contains all configuration elements for Coordinated Meetings.
		`enabled`	Determines whether Teams is configured to participate in Coordinated Meetings with other devices. Accepted values: `true`, `false`
`<CoordinatedMeetings>`	`<TrustedAccounts>`		This is a comma-separated list of UPNs for each Teams Rooms device or Surface Hub that the device should accept meeting join requests from, or to which meeting join requests should be sent. Accepted values: string
`<CoordinatedMeetings>`	`<Settings>`		Contains configuration audio and video configuration elements for Coordinated Meetings
`<Settings>`	`<Audio>`		Controls audio configuration for Teams on a Surface Hub.
		`default`	Determines on which device the microphone will be active when a meeting starts. Only one device (typically a Teams Rooms device) can have this field set to `true` while the rest of the devices must have this field set to `false` to avoid audio echo and feedback. Accepted values: `true`, `false`
		`enabled`	Determines whether participants in a meeting can toggle the microphone on or off. Devices on which Audio default is set to `false` should have this setting set to `false` so that participants can't accidentally turn on a microphone and cause audio echo or feedback. If Audio default is set to `true`, this setting is ignored and participants can mute or unmute the microphone. Accepted values: `true`, `false`
`<Settings>`	`<Video>`		Controls video configuration for Teams on a Surface Hub.
		`default`	Determines on which device the camera will be active when a meeting starts. For the best experience, we recommend that only the Teams Rooms device be set to `true` while all other devices are set to `false`. Accepted values: `true`, `false`
		`enabled`	Determines whether participants in a meeting can toggle the camera on or off. You can set this to `true` on any other devices in the event participants want to share different video perspectives (such as if a participant is using the Surface Hub whiteboard). If you don't want participants to turn a camera on or off on a device, set this to `false`. If Video default is set to `true`, this setting is ignored and participants can turn the camera on or off. Accepted values: `true`, `false`

Apply Teams settings to Surface Hub

Apply or update Teams configuration settings on Surface Hub using either Windows Configuration Designer or Microsoft Intune in Microsoft Endpoint Manager.

Use Windows Configuration Designer

You can use Windows Configuration Designer to create a provisioning package that you can use to apply Teams settings to your Surface Hubs. You'll paste the XML file you created above into Windows Configuration Designer to create the provisioning package.

Important

If you've already applied Teams configuration to your Surface Hub using a provisioning package and want to change it, you need to remove the existing provisioning package first. For more information, see Remove a provisioning package created by Windows Configuration Designer.

Do the following to create the provisioning package in Windows Configuration Designer:

Install Windows Configuration Designer from the Windows Store on your local computer and open it
Select Provision Surface Hub devices and then Switch to advanced editor
On the next screen, expand WindowsTeamSettings > Teams and select Configurations
In the field next to Configurations in the middle pane, paste the single line of XML you created above
Select Export > Provisioning package
Provide a name for the provisioning package in Name and select Next > Next
Specify a location to save the provisioning package and select Next
Select Build to create the provisioning package and then Finish

Finally, after you've created the provisioning package, do the following to apply the provisioning package to your Surface Hub:

Save the provisioning package you created above to a USB drive
Insert the USB drive into your Surface Hub
On your Surface Hub, open the Start menu, select All apps, and then select Settings
Provide your admin username and password and then select Yes
Go to Surface Hub, Device management, Add or remove a provisioning package, and then Add a package
Under Select a package, select Add next to your provisioning package, and then restart your Surface Hub

Use Microsoft Intune

If your Surface Hubs are managed using Microsoft Intune in Microsoft Endpoint Management, you can use it to apply Teams settings to your Surface Hubs. You'll create a new configuration profile and then paste the XML file you created above into it.

Important

Your Surface Hubs need to be in a device group so that the Microsoft Intune can identify which devices to apply the configuration profile to. For information about how to create a device group, see Add groups to organize users and devices.

Do the following to create a configuration profile to apply Teams settings to your Surface Hubs:

Sign in to Microsoft Endpoint Manager by visiting https://endpoint.microsoft.com/
Navigate to Devices > Configuration profiles and select Create profile
Under Platform, select Windows 10 and later
Under Profile, select Custom, and then click Create
On the Basics tab, in Name, provide a descriptive name for your configuration profile and select Next
On the Configuration settings tab, select Add
In the Add row pane, do the following:
1. Provide a descriptive name and, optionally, a description of the Teams setting you're adding
2. In OMA-URI, enter ./Vendor/MSFT/SurfaceHub/InBoxApps/Teams/Configurations
3. In Data type, select String (XML file)
4. Open the file browser, select the XML file you created above, and Open
Select Add and then Next
On the Assignments tab, make sure Assign to is set to Selected groups
Under Selected groups, select Select groups to include and choose the group that contains your Surface Hubs, and then select Select
Select Next, Next
On the Review + create, select Create

Remove Teams settings from a Surface Hub

Remove Teams configuration settings on Surface Hub using either Windows Configuration Designer or Microsoft Intune in Microsoft Endpoint Manager.

Remove a provisioning package created by Windows Configuration Designer

If you applied Teams settings to a Surface Hub using a provisioning package created by Windows Configuration Designer, use the following steps to remove the package and its settings:

On your Surface Hub, open the Start menu, select All apps, and then select Settings
Provide your admin username and password and then select Yes
Go to Surface Hub, Device management and then Add or remove a provisioning package
Next to the provisioning package you want to remove, select Remove
Go to Surface Hub and then Apps & features
Find Microsoft Teams for Surface Hub and then select Advanced Options
Select Reset, and then Reset again
Restart your Surface Hub

Remove settings applied by Microsoft Intune

If you applied Teams settings to a Surface Hub using Microsoft Intune in Microsoft Endpoint Management, use the following steps to remove the configuration profile and its settings:

Sign in to Microsoft Endpoint Manager by visiting https://endpoint.microsoft.com/
Navigate to Devices > Configuration profiles
Select the configuration profile that contains the Coordinated Meeting settings you want to remove
On the configuration profile details page, select Delete and then OK

After you've removed configuration profile that contained the Coordinated Meeting settings for your Surface Hub, use the following steps to reset the Teams app on the Surface Hub:

On your Surface Hub, open the Start menu, select All apps, and then select Settings
Provide your admin username and password and then select Yes
Go to Surface Hub and then Apps & features
Find Microsoft Teams for Surface Hub and then select Advanced Options
Select Reset, and then Reset again
Restart your Surface Hub