--- title: SurfaceHub DDF file description: View the XML file containing the device description framework (DDF) for the SurfaceHub configuration service provider. ms.date: 01/18/2024 --- # SurfaceHub DDF file The following XML file contains the device description framework (DDF) for the SurfaceHub configuration service provider. ```xml ]> 1.2 SurfaceHub ./Vendor/MSFT The root node for the Surface Hub configuration service provider. 10.0.10586 1.0 0x4;0x1B;0x30;0x31;0x48;0x54;0x62;0x63;0x64;0x65;0x77;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xAF;0xB4;0xBC;0xBF;0xCA;0xCB;0xCD; DeviceAccount Node for setting device account information. A device account is a Microsoft Exchange account that is connected with Skype for Business, which allows people to join scheduled meetings, make Skype for Business calls, and share content from the device. See the Surface Hub administrator guide for more information about setting up a device account. To use a device account from Azure Active Directory: 1. Set the UserPrincipalName (for Azure AD). 2. Set a valid Password. 3. Execute ValidateAndCommit to validate the specified username and password combination against Azure AD. 4. Get the ErrorContext in case something goes wrong during validation. DomainName Domain of the device account when you are using Active Directory. To use a device account from Active Directory, you should specify both DomainName and UserName for the device account. UserName Username of the device account when you are using Active Directory. To use a device account from Active Directory, you should specify both DomainName and UserName for the device account. UserPrincipalName User principal name (UPN) of the device account. To use a device account from Azure Active Directory or a hybrid deployment, you should specify the UPN of the device account. Password Password for the device account. Get is allowed here, but will always return a blank. ValidateAndCommit This method validates the data provided and then commits the changes. ExchangeServer Exchange server of the device account. Normally, the device will try to auto-discover the Exchange server. This field is only required if auto-discovery fails. SipAddress Session Initiation Protocol (SIP) address of the device account. Normally, the device will try to auto-discover the SIP. This field is only required if auto-discovery fails. Email Email address of the device account. CalendarSyncEnabled Specifies whether calendar sync and other Exchange server services is enabled. false Disabled true Enabled ErrorContext If there is an error calling ValidateAndCommit, there will be additional context for that error in this node. PasswordRotationPeriod Specifies whether automatic password rotation is enabled. If you enforce a password expiration policy on the device account, use this setting to allow the device to manage its own password by changing it frequently, without requiring you to manually update the account information when the password expires. You can reset the password at any time using Active Directory (or Azure AD). 0 Password rotation enabled 1 Disabled ExchangeModernAuthEnabled True Specifies whether Device Account calendar sync will attempt to use token-based Modern Authentication to connect to the Exchange Server. 10.19041.789, 10.19042.789, 99.9.9999 1.0 False Disabled True Enabled MaintenanceHoursSimple Node for maintenance schedule. Hours Node for maintenance schedule. StartTime Specifies the start time for maintenance hours in minutes from midnight. For example, to set a 2:00 am start time, set this value to 120. [0-1439] Duration Specifies the duration of maintenance window in minutes. For example, to set a 3-hour duration, set this value to 180. [0-1439] InBoxApps Node for the in-box app settings. SkypeForBusiness Node for the Skype for Business settings. DomainName Specifies the domain of the Skype for Business account when you are using Active Directory. For more information, see https://docs.microsoft.com/en-us/SkypeForBusiness/set-up-skype-for-business-online/set-up-skype-for-business-online?redirectSourcePath=%252fen-us%252farticle%252fSet-up-Skype-for-Business-Online-40296968-e779-4259-980b-c2de1c044c6e#bkmk_users 10.0.15063 1.0 Welcome Node for the welcome screen. AutoWakeScreen Setting for the screen to wake up and stay on with sensor activity. False Disabled True Enabled CurrentBackgroundPath Background image for the welcome screen. To set this, specify an https URL to a PNG file (only PNGs are supported for security reasons). If any certificate authorities need to be trusted in order to access the URL, please ensure they are valid and installed on the Hub, otherwise it may not be able to load the image. MeetingInfoOption Meeting information displayed on the welcome screen. 0 Organizer and time only. 1 Organizer, time, and subject. Subject is hidden in private meetings. WirelessProjection Node for the wireless projector app settings. PINRequired Users must enter a PIN to wirelessly project to the device. false Pin not required true Pin required Enabled Enables wireless projection to the device. false Disabled true Enabled Channel 255 Wireless channel to use for Miracast operation. The supported channels are defined by the Wi-Fi Alliance Wi-Fi Direct specification. Connect Node for the Connect app. AutoLaunch Specifies whether to automatically launch the Connect app whenever a projection is initiated. If this setting is true, the Connect app will be automatically launched. If false, the user will need to launch the Connect app manually from the Hub’s settings. 10.0.15063 1.0 false Disabled true Enabled Whiteboard This node controls policies specific to the Whiteboard App on Surface Hub. 10.0.18363, 10.0.18362.449 1.0 SignInDisabled False When enabled, prevents a user from Signing into Whiteboard on the device False Sign in enabled True Sign in disabled TelemetryDisabled False When enabled, prevents Whiteboard from sending telemetry from the device False Telemetry enabled True Telemetry disabled SharingDisabled When enabled, prevents a user from initiating a collaborative session on the device False Sharing enabled True Sharing disabled Teams This node controls policies specific to the Teams App on Surface Hub 10.0.19042, 10.0.19041.450 1.0 Configurations String to contain Teams policy configs Properties Node for the device properties. FriendlyName Friendly name of the device. Specifies the name that users see when they want to wirelessly project to the device. DefaultVolume 45 Specifies the default volume value for a new session. 10.0.15063 1.0 [0-100] ScreenTimeout 5 Specifies the number of minutes until the Hub screen turns off. 10.0.15063 1.0 0 Never time out 1 1 minute 2 2 minutes 3 3 minutes 5 5 minutes 10 10 minutes 15 15 minutes 30 30 minutes 60 1 hour 120 2 hours 240 4 hours SleepMode 0 Specifies the type of sleep mode for the Surface Hub. 10.0.15063 1.0 0 Connected Standby 1 Hibernate SessionTimeout 1 Specifies the number of minutes until the session times out. 10.0.15063 1.0 0 Never time out 1 1 minute 2 2 minutes 3 3 minutes 5 5 minutes 10 10 minutes 15 15 minutes 30 30 minutes 60 1 hour 120 2 hours 240 4 hours SleepTimeout 5 Specifies the number of minutes until the Hub enters sleep mode. 10.0.15063 1.0 0 Never time out 1 1 minute 2 2 minutes 3 3 minutes 5 5 minutes 10 10 minutes 15 15 minutes 30 30 minutes 60 1 hour 120 2 hours 240 4 hours AllowSessionResume true Specifies whether to allow the ability to resume a session when the session times out. If this setting is true, the "Resume Session" feature will be available on the welcome screen when the screen is idle. If false, once the screen idles, the session will be automatically cleaned up as if the “End Session" feature was initiated. 10.0.15063 1.0 false Disabled true Enabled DefaultAutomaticFraming true Specifies whether the Surface Hub 2 Smart Camera feature to automatically zoom and keep users centered in the video is enabled. 10.0.19042 1.0 false Disabled true Enabled AllowAutoProxyAuth true Specifies whether to use the device account for proxy authentication. If this setting is true, the device account will be used for proxy authentication. If false, a separate account will be used. 10.0.15063 1.0 false Disabled true Enabled DisableSigninSuggestions false Specifies whether to disable auto-populating of the sign-in dialog with invitees from scheduled meetings. If this setting is true, the sign-in dialog will not be populated. If false, the dialog will auto-populate. 10.0.15063 1.0 false Dialog will auto-populate. true Sign-in dialog will not be populated. SurfaceHubMeetingMode 0 Teams mode 10.0.15063, 10.0.14393.969 1.0 [0-2] VtcAppPackageId App name 10.0.15063, 10.0.14393.969 1.0 DoNotShowMyMeetingsAndFiles false Specifies whether to disable the "My meetings and files" feature in the Start menu, which shows the signed-in user's meetings and files from Office 365. If this setting is true, the “My meetings and files” feature will not be shown. When false, the “My meetings and files” feature will be shown. 10.0.15063 1.0 true "My meetings and files" feature will not be shown. false The "My meetings and files" feature will be shown. ProxyServers The list of known proxy servers to provide. Management Not a supported scenario 10.0.15063, 10.0.14393.969 1.0 GroupName The name of the domain admin group to add to the administrators group on the device. GroupSid The sid of the domain admin group to add to the administrators group on the device. MOMAgent Node for the Microsoft Operations Management Suite. WorkspaceID GUID identifying the Microsoft Operations Management Suite workspace ID to collect the data. Set this to an empty string to disable the MOM agent. WorkspaceKey Primary key for authenticating with workspace. Will always return an empty string. Dot3 Parent node 10.0.17134, 10.0.16299.64 1.0 LanProfile Used to specify credentials to authenticate device to the network. EapUserData Used to specify credentials to authenticate device to the network. ``` ## Related articles [SurfaceHub configuration service provider reference](surfacehub-csp.md)