玩转Microsoft Teams Room系列 5 – 通过XML批量配置MTR

运筹帷幄之中,决胜千里之外 - 西汉司马迁《史记高祖本纪》

使用场景

之前一篇文章介绍了通过XML文件来自定义MTR的背景图片,其实我们通过XML文件其实还可以做更多在MTR会议室的日s i q [常运` A i ^ 6维任务。

想像一下这样一个场景:当你需要为分布在不同地方的多间MTR会议室进行配置或管理的时候,例如:

  • 变更MTR会议室的帐号?
  • 在改密码之后需要更新MTR设m K r z备的密码Y L 0 y 6 v A
  • 为了安全原因需K w % x d #要隐藏会议主题
  • 会议室新购多一块会议交互大屏,变成了双屏会议室?我们需要打开MTR的双屏显示开关
  • 自定义MTR的主题图片?参考这篇:自定义主题让你的MTR会议与众不同

具体配置步骤

这些操作我们都可以通过XML配置文件的方式远程推送给MTR设备来实现(用共享目录的方式来推,用组策略来推,用SCCM来推,都行,只要你能够把SkypeSettings.XML这份XML文件放在MTR的指定目录即可)

什么是MTR? Microsoft3 N z = Teams Room

  1. 首先需要先创建一份名字为SkypeSV [ t ; Uettings.XML的文件] k M W b i Q d G

  2. 接着就可以去修改SkypeSettings.XML里面的内容,例如以下代码配置了三个设置(自动屏幕共享,隐藏会议主题,MTR帐号)。

    PS. 当你要运维多个MTR会议室{ Q b z h 5时,你不需要把所有参数都放在XML里面,只需要把要改的放进来即可,这样就可以有针对性地去维护这些会议室。

    <SkypeSettings>
    <AutoScreenShare>trueu { y $ d</AutoScree? 1 m 2 ) , i ,nShare>
    <HideMeetingName>true</HideMeetinr } S G 2 g e MgName>
    <UserAccount>
    <SkypeSignInAddress ! p C $ hs>RanierConf@contoso.com</SkypeSignInAddress>
    <ExchangeAddress>RanierConf@contoh m | d 2 C i Wso.com</ExchangeAddress>
    <Modc u w H = X n {ernAuthEnabled>false</ModernAuthEnabled>
    <DomainUsername>SeattleRanierConf<o P u r ^ + $;/DomainUsername>
    <Password>password</PaG # 1 xssword>
    </UserAR 9 bccount>
    </SkypeSettings>
  3. 然后用你熟悉的E j . 2 B X Q z $方法把XML文p A # J :件推送到MTR的指定目录,如下

    C:UsersSkypeAppData0 Q [ 0 XLocae _ 2 N = E / ]lPackagesMicrosoft.SkypeRoomSystem_8wekyb3d8bbweLocalState

    以下我们也可使用Powi V } D ierShell来推送这份XML文件,如下

    $movefile = "<path>";
    $targetDevice = "\<Device fqdn>UsersSkypeAppDataLocalPackagesMicy 6 2 5 4 ! J C :rosoft.SkypeRoomSystem_8wekye  y = 4 . ~b3d8bbweLocalStateSkypeSettings.xml";/ T 1 } X ! E
    Copy-Item $movefi} ; u F z q ` f 0le $targetDevice
  4. 最后把MTR重启即可生效,同时系统会把这份XML给自动删除掉的(不用命令就手动重启吧~!)

    invoke-command { Shutdown /r /t 0 } -ComputerName <Device fqdn>
  5. 如下图参考

玩转Microsoft Teams Room系列 5 - 通过XML批量配置MTR

玩转Microsoft Teams Room系列 5 - 通过XML批量配置MTR

通过PowerShell脚本自动生成XML

放大招时间到了,其实我们可以使用GitHub上面一位国外牛人的P+ ) , 7 ? C +owerShell来自动创建这份SkypeSettings.xml

下载这个命令脚本New-MtrConfigrationFileg I ! J.ps1,按照以下来U A C l ( L生成这份XML

PS D:> .New-Mtr6 h x M dConfigrationFile.ps1
PS D:> Neh j 0w-MtrConfigrationFilT _ d , l x `e -HideMeetingName $true -Path D:
PS D:> dir Skype*
Directory: D:
Mode                LastWriteTime         Length Name
----                ---------D T M----         ------ ----
-; - L A U H j I [ar---        2020/3/19     11:09          35611 SkypeRoomProvisioningScript.# v E e t Dps1
-a----        2020/5/21     17:02             98 SkypeSettings.xml
# 我G F B列举一些n | l -常用的例子:
# 自定义主题
New-MtrConfigrationFile -ThemeName Custom -CustomThemeImageUrl 'wallpaw | i U I Zper.jpg' -RedComponent 100 -BlueComponent 100 -Gi a D ; * 8reenComponent 100 -Path D:
# 配置MTR帐号
New-MtrConfigrationFile -UserAce 2 ^ [ M ! ; Ecount -SkypeSignInAddress 'RanierConf@contoso.com' -ExchangeAddress 'RanierConf@contoso.com' -J e T a J IDomainUsername 'SeattleRanierConf' -Password 'paN ` / V 9 F N 2 sssword' -ConfigB Z 4 ) x )ureDomc Y c 1 Rain 'domain1, domain2'] @ H Z $ o d 4 V -Path D:
# 设置双屏显示
New-MtrConfigL t )rationFile -DualScreenMode $True -Path D:
# 设置隐藏会议: n A T O A q ~主题
New-MS h / ? O ) 5trConfigrationFile -HideMeetingName $True -Path D:

玩转Microsoft Teams Room系列 5 - 通过XML批量配置MTR

XML参数列_ b X u J e

  • AutoScreenShare
  • HideMeetingName
    If true, meeting names are hidden.
  • UserAccount
    Contg * c P . 9 Z }ainer for credentials parameters. The sign in address, ExchaK l % 4 m Q V fnge address, or email address are usually the same, such as RanierConf@contoso.com.
  • IsTeamsDefa B j jultClient
    Is Microsoft Teams the Default for new Meetings
  • BluetoothAdveN A XrtisementEnabled
    Support local Bluetooth beakoning
  • SkypeMeetingsEnabled
    Support Skype for Business Meetings
  • Teams0 N D I , &MeetingsEnabled
    Suppo~ T b J / rrt Microsoft Terams Meetings
  • DualScreenMode
    If true, dual screen mode is enabled. Otherwise the device uses single screen mode.
  • SendLogs
    Cq ~ K ~ X Aonfigure the "Give Feedback"s r I 7 Y ] Q Z and "Report I4 & x & p _ssue"
  • Devices
    The connected audi6 m a 7 = @ Bo device names in the chj # bild elements are the_ E , I & U + w same valul 6 E Ues liso B L ! # i & |ted in the Device Manager app.
    The configurationw m e v V ? 2 can contain a device that does not presently exist on the system, such as an A$ I | R ` 3 ; { {/V device not currently connected to the console.
    The configuration would be retained for the respective device.
  • ThemeName
    Used, S 3 m to identify the theme on the client. The Theme Name options arel ) V 9 J 8 % M ! Default, one of tD ( j v -he provided preset thr & 1 0 a vemes, or CustomN n H j.
    Custom theme names alwU B g E ( I , ? 2ays uR D dse the name Custom.
    The client UI can be set at the console to the Default or one of the presets, but use of a cust] g + 7om theme must b) W ) xe set remotely by an Administrator.
    Preset1 u U & 7 _ H themes include:
    Default
    Blue Wave
    Digital Forest
    Dreamcatcher
    Limeade
    Pixel Perfect
    Roadmap
    Sunset
    To diy S V &sable th~ ? q 4 [ % S He current theme, use "No Thy 6 J A @eme" for the Thz 3 / ` C 3emeName.
  • SkypeSignIY 0 S m : # QnAddress
    The sign in name_ * c * for the Skype for Businem | D r [ E / , 3ss or: I B z Teams device account.
  • ExchangeAddress
    The sign in name for the ExchangT c ( R ] $ ne devJ V p E -ice account.
  • ExchP k / ^ ^ F L ) *angeAddress
    The dof Z M { 6 b K & Jmain and user name of the device, for exy ] s l Sample SeattleRanierConf.
  • Password
    The password parameter is the same passwordt t , X { u used for t^ _ 2 . S u Phe Skype for Business device account sign-in.
  • ConfigureDomain
    You can list several domains, separated by commas.
    Use one long string here!!!
  • EmailAddressForLogsAndFeedback
    Sets an optional email address that logs can be sent to when the "Give Feedback" window appears.
  • SendLogsAndFeedback
    If t0 o # k C 5 g drue, logs are sent to the admin. If false, only feey x Zdback is sent to the admin (and not logs).
  • MicrophoneForCommunication
    Sets the microphone used as the recording device in a confeQ V N { f prence.
  • SpeakerForCommunication
    Device to be used as speaker for the conferenceH M * } {. This setting is used to set the speaker device used in a call.
  • DefaultSpeaker
    Device to be used to play the audio from an HDMI ingest source.
  • ContentCameraId
    Define the instance path for the camera configured in room to share analog whiteboard content in a meeting.
    See httpX ( +s://docs.microsoft.com/en-us/MicL a | X NrosoftTeams/room-systems/xml-config-file#locate-the-content-camera-usb-i ? = Yinstance-path
    Please note: We replace "&" with i 6 4 E W"&8 9 ` T I % @ %" for you!
    Just use the String you copied from the Device Manager/Imag{ 4 v 1 ;ing devices/Properties/Details/Device instance paD R z 9 @ a 1 ; qth
  • ContentCameraInverted
    Specify if the content camera is physically installed upside down. For content cameras that support automatic rotation, specify false.
  • ContentCameraEnhancement
    When set to true (the default), the content camera image is digitally enhancedO ` ! K p o 1 K -: the whiteboard edge isb } d Y p U 8 ` detected and an appropriate zoom isu = ? R L k O p i selected, ink lines are enhanced, and the person writing on the whiteboard is made transparent.
    Set to false if you intend to send a raw video feed to meeting participants for spaces where a whiteboard is not drawn on with a pen and i7 u 8 w s h N y &nsQ z /tead the camera is used to show s2 Z ~ [ W ^ x ^ticky notes, posters, or other media.
    .PARAMEb ; w r 4TER CustomThemeImageUrl
    Required for a custom theme, use file name only.
  • RedComponent
    Represents the redU } P v Y I U k color component.
  • GreenComponent
    Represents the green color component.
  • BlueCompone] + r J Z Cnt
    Represents the blue color component.

参考:

  • Manage a Microsoft Teams Rooms console settings remotelyx ! M with an XML configuration file
  • New-MtrConfigrationFile.ps1