Manage a Skype Room Systems v2 console settings remotely with an XML configuration file

Skype for Business Server 2015
 

마지막으로 수정된 항목: 2017-07-14

This article discusses remote management of the default settings used by a UNRESOLVED_TOKEN_VAL(SkypeRoomSystemv2) device, including applying a custom theme.

Updating a master XML file and sending copies to the consoles you manage makes it possible for you to change default settings for remotely managed devices. This article discusses how to create such a file, and links to discussions of how to place them as needed on the remotely managed devices. Using this method, you can also implement Custom Themes on your UNRESOLVED_TOKEN_VAL(SkypeRoomSystemv2) consoles.

The table below explains the elements shown in this sample SkypeSettings.xml (this is a required file name) configuration file.

<SkypeSettings>
  <AutoScreenShare>true</AutoScreenShare>
  <HideMeetingName>true</HideMeetingName>
  <UserAccount>
             <SkypeSignInAddress>RanierConf@contoso.com</SkypeSignInAddress>
             <ExchangeAddress>RanierConf@contoso.com</ExchangeAddress>
             <DomainUsername>Seattle\RanierConf</DomainUsername>
             <Password>password</Password>
             <ConfigureDomain>domain1, domain2</ConfigureDomain>
             <AutoRotatePassword>1</AutoRotatePassword>
  </UserAccount>                                                        
  <DualScreenMode>true</DualScreenMode>
  <SendLogs>                           
             <EmailAddressForLogsAndFeedback>RanierConf@contoso.com</EmailAddressForLogsAndFeedback>
	            <SendLogsAndFeedback>true</SendLogsAndFeedback>
  </SendLogs>
  <Devices>
              <MicrophoneForCommunication>Microsoft LifeChat LX-6000</MicrophoneForCommunication>
              <SpeakerForCommunication>Realtek High Definition Audio</SpeakerForCommunication>
              <DefaultSpeaker>Polycom CX5100</DefaultSpeaker>
  </Devices>
  <Theming> 
    <ThemeName>Custom</ThemeName>
	   <CustomThemeImageUrl>folder path</CustomThemeImageUrl>
      <CustomThemeColor>
	       <RedComponent>100</RedComponent>
	       <GreenComponent>100</GreenComponent>
	       <BlueComponent>100</BlueComponent>
 	     </CustomThemeColor>
  </Theming>
</SkypeSettings>

If the XML file is badly formed (meaning a variable value is of the wrong type, elements are out of order, elements are unclosed, and so on), settings found up to the point where the error is found are applied, then the rest of the file is ignored during processing. Any unknown elements in the XML are ignored. If a parameter is omitted, it remains unchanged on the device. If a parameter’s value is invalid, its prior value remains unchanged.

XML elements

ElementTypeLevelUsage

<SkypeSettings>

Container for all elements.

 

Required.

<AutoScreenShare>

Boolean 2

First 1

If true, auto screen share is enabled.

<HideMeetingName>

Boolean 2

First 1

If true, meeting names are hidden.

<UserAccount>

Container

First 1

Container for credentials parameters.

The sign in address, Exchange address, or email address are usually the same, such as RanierConf@contoso.com.

<SkypeSignInAddress>

String 3

 

The sign in name for the console's Skype for Business device account.

<ExchangeAddress>

String 3

 

The sign in name for the console's Exchange device account.

If the ExchangeAddress is omitted, the SkypeSignInAddress will not automatically be re-used.

<DomainUsername>

String 3

 

The domain and user name of the console device, for example Seattle\RanierConf.

<Password>

String 3

 

The password parameter is the same password used for the Skype for Business device account sign-in.

<ConfigureDomain>

String 3

 

You can list several domains, separated by commas.

<AutoRotatePassword>

Boolean 2

  

<DualScreenMode>

Boolean 2

First 1

If true, dual screen mode is enabled. Otherwise the device will use single screen mode.

<SendLogs>

Container

First 1

 

<EmailAddressForLogsAndFeedback>

String 3

 

This sets an optional email address that logs can be sent to when the "Give Feedback" window appears.

<SendLogsAndFeedback>

Boolean 2

 

If true, logs are sent to the admin. If false, only feedback is sent to the admin (and not logs).

<Devices>

Container

First 1

The connected audio device names in the child elements are the same values listed in the Device Manager app. The configuration can contain a device that does not presently exist on the system, such as an A/V device not currently connected to the console. The configuration would be retained for the respective device.

<MicrophoneForCommunication>

String 3

 

Sets the microphone that will be used as the recording device in a conference.

<SpeakerForCommunication>

String 3

 

Device to be used as speaker for the conference. This setting is used to set the speaker device that will be used hear the audio in a call.

<DefaultSpeaker>

String 3

 

Device to be used to play the audio from an HDMI ingest source.

<Theming>

Container

First 1

One of the features that can be applied using an XML file is a Custom Theme for your organization. You will be able to specify a theme name, background image, and color.

<ThemeName>

String 3

 

Used to identify the theme on the client. The Theme Name options are Default, one of the provided preset themes, or Custom.

Custom theme names should always use the name Custom. The client UI can be set at the console to the Default or one of the presets, but applying a custom theme must be set remotely by an Administrator.

Preset themes include:

  • Default

  • Blue Wave

  • Digital Forest

  • Dreamcatcher

  • Limeade

  • Pixel Perfect

  • Roadmap

  • Sunset

To disable the current theme, use “No Theme” for the ThemeName.

<CustomThemeImageUrl>

String 3

 

Required if using a custom theme, otherwise optional. See the Custom Theme Images section below for more details on the custom theme image.

<CustomThemeColor>

Container

 

Container for the <RedComponent>, <GreenComponent>, and <BlueComponent> values. These values are required if using a custom theme.

<RedComponent>

Byte (0-255)

 

Represents the red color component.

<GreenComponent>

Byte (0-255)

 

Represents the green color component.

<BlueComponent>

Byte (0-255)

 

Represents the blue color component.

1 All of the first-level elements are optional. If a first-level element is omitted, all of its child parameters remain unchanged on the device.

2 A boolean flag can be any of the following: true, false, 0, or 1. Boolean or numeric values left empty might render the XML malformed so there would be no changes to the settings.

3 If a string parameter is present, empty, and empty is a valid value, the parameter is cleared on the device.

At startup, if a UNRESOLVED_TOKEN_VAL(SkypeRoomSystemv2) console finds an XML file named SkypeSettings.xml at the location C:\Users\Skype\AppData\Local\Packages\Microsoft.SkypeRoomSystem_8wekyb3d8bbwe\LocalState, it will apply the configuration settings indicated by the XML file then delete the XML file.

Depending on how many UNRESOLVED_TOKEN_VAL(SkypeRoomSystemv2) devices your enterprise has and how you choose to manage to configure them, there are a number of ways to place the XML configuration file. Once the file is pushed to the console, restart it to process the configuration changes. The XML configuration file is deleted after it is successfully processed. The management methods suggested for UNRESOLVED_TOKEN_VAL(SkypeRoomSystemv2) devices are discussed in:

You are free to use any method you like so long as you can use it to transfer files and trigger a restart on the console device. The file must be readable, writable, and delete-able by the device’s local user account (preferably, it should be owned by and have full privileges granted to that user). If the file permissions are not set correctly, the software may fail to apply the settings, may fail to delete the file upon successful processing, and could even potentially crash.

The custom theme image file must be placed in C:\Users\Skype\AppData\Local\Packages\Microsoft.SkypeRoomSystem_8wekyb3d8bbwe\LocalState, just enter the file name and extension in the <CustomThemeImageUrl> variable.

The image file should be exactly 3840X1080 pixels and must be one of the following file formats: jpg, jpeg, png and bmp. If your organization wants a custom image, a graphic designer will find our Custom Theme Photoshop Template useful. It contains further detail on where to place various elements in a theme image and what areas appear on consoles and displays.

The XML configuration file must be updated at device startup to recognize the theme image. Once the new XML file is processed and deleted, the theme graphic file will be deleted from the directory.

 
표시: