Microsoft Teams Rooms のコンソールの設定を、XML 構成ファイルを使用してリモートで管理する
この記事では、カスタム テーマの適用など、 Microsoft Teams Rooms デバイスによって使用される既定の設定のリモート管理について説明します。 マスター設定ファイルを作成する方法と、必要に応じてTeams Roomsに配置する方法に関する説明へのリンクについて説明します。
マスター XML ファイルを更新し、リモート Teams Rooms デバイスにコピーを送信することで、Teams Roomsの既定の設定を変更できます。
XML 構成ファイルを作成する
任意のテキスト エディターを使用して、設定ファイルを作成できます。 XML要素 の表に、サンプルの SkypeSettings.xml （必須のファイル名） 構成ファイルに含まれる要素を説明します。
<SkypeSettings>
<AutoScreenShare>1</AutoScreenShare>
<HideMeetingName>1</HideMeetingName>
<AutoExitMeetingEnabled>true</AutoExitMeetingEnabled>
<AudioRenderDefaultDeviceVolume>70</AudioRenderDefaultDeviceVolume>
<AudioRenderCommunicationDeviceVolume>30</AudioRenderCommunicationDeviceVolume>
<UserAccount>
<SkypeSignInAddress>username@microsoft.com</SkypeSignInAddress>
<ExchangeAddress>username@microsoft.com</ExchangeAddress>
<DomainUsername>domain\username</DomainUsername>
<Password>Password!</Password>
<ConfigureDomain>domain1, domain2</ConfigureDomain>
<ModernAuthEnabled>true</ModernAuthEnabled>
</UserAccount>
<TeamsMeetingsEnabled>true</TeamsMeetingsEnabled>
<SfbMeetingEnabled>true</SfbMeetingEnabled>
<IsTeamsDefaultClient>true</IsTeamsDefaultClient>
<WebexMeetingsEnabled>true</WebexMeetingsEnabled>
<ZoomMeetingsEnabled>true</ZoomMeetingsEnabled>
<UseCustomInfoForThirdPartyMeetings>true</UseCustomInfoForThirdPartyMeetings>
<CustomDisplayNameForThirdPartyMeetings>guestname</CustomDisplayNameForThirdPartyMeetings>
<CustomDisplayEmailForThirdPartyMeetings>guest@microsoft.com</CustomDisplayEmailForThirdPartyMeetings>
<BluetoothAdvertisementEnabled>false</BluetoothAdvertisementEnabled>
<AutoAcceptProximateMeetingInvitations>true</AutoAcceptProximateMeetingInvitations>
<CortanaWakewordEnabled>true</CortanaWakewordEnabled>
<DualScreenMode>0</DualScreenMode>
<DuplicateIngestDefault>true</DuplicateIngestDefault>
<DisableTeamsAudioSharing>true</DisableTeamsAudioSharing>
<FrontRowEnabled>true</FrontRowEnabled>
<SingleFoRDefaultContentLayout>1</SingleFoRDefaultContentLayout>
<DefaultFoRExperience>0</DefaultFoRExperience>
<EnablePublicPreview>false</EnablePublicPreview>
<NoiseSuppressionDefault>1</NoiseSuppressionDefault>
<SendLogs>
<EmailAddressForLogsAndFeedback>username@microsoft.com</EmailAddressForLogsAndFeedback>
<SendLogsAndFeedback>True</SendLogsAndFeedback>
</SendLogs>
<Devices>
<MicrophoneForCommunication>Device1</MicrophoneForCommunication>
<SpeakerForCommunication>DeviceX</SpeakerForCommunication>
<DefaultSpeaker>DeviceX</DefaultSpeaker>
<ContentCameraId>Camera1</ContentCameraId>
<ContentCameraEnhancement>true</ContentCameraEnhancement>
<ContentCameraInverted>false</ContentCameraInverted>
</Devices>
<Theming>
<ThemeName>Custom</ThemeName>
<CustomThemeImageUrl>file name</CustomThemeImageUrl>
<CustomThemeColor>
<RedComponent>100</RedComponent>
<GreenComponent>100</GreenComponent>
<BlueComponent>100</BlueComponent>
</CustomThemeColor>
</Theming>
<CoordinatedMeetings enabled="true">
<TrustedAccounts>username1@microsoft.com,username2@contoso.com</TrustedAccounts>
<Settings>
<Audio default="true" enabled="true"/>
<Video default="true" enabled="true"/>
<Whiteboard default="true" enabled="true"/>
</Settings>
</CoordinatedMeetings>
<EnableResolutionAndScalingSetting>true</EnableResolutionAndScalingSetting>
<MainFoRDisplay>
<MainFoRDisplayResolution>1920,1080</MainFoRDisplayResolution>
<MainFoRDisplayScaling>100</MainFoRDisplayScaling>
</MainFoRDisplay>
<ExtendedFoRDisplay>
<ExtendedFoRDisplayResolution>1920,1080</ExtendedFoRDisplayResolution>
<ExtendedFoRDisplayScaling>100</ExtendedFoRDisplayScaling>
</ExtendedFoRDisplay>
</SkypeSettings>
変数の型の値が間違っている、要素が順番に表示されていない、要素が閉じられていない、または別のエラーが発生した場合、XML ファイルは 形式が正しくない 状態です。 形式が正しくない XML ファイルを処理しているときに、エラーの発生が適用される時点までの設定が検出されると、ファイルの残りの部分が無視されます。 XML 内の不明な要素は無視されます。 パラメーターは削除されると、変更されないままデバイス上に残ります。 パラメーター値が無効な場合、前の値が変更されないまま残ります。
XML 要素
| 要素 | 型 | レベル | 使用方法 |
|---|---|---|---|
<SkypeSettings> |
すべての要素のコンテナー。 | 必須です。 | |
<AutoScreenShare> |
ブール値 ❷ | First ❶ | True の場合、[自動画面共有] が有効になります。 |
<HideMeetingName> |
ブール値 ❷ | First ❶ | True の場合、会議名は非表示になります。 |
<UserAccount> |
コンテナー | First ❶ | 資格情報パラメーター用のコンテナー サインイン アドレス、Exchange アドレス、またはメールアドレスは、通常は同一のものとなります (RanierConf@contoso.com など)。 |
<SkypeSignInAddress> |
文字列❷ | コンソールの SfB または Teams デバイス アカウントのサインイン名。 | |
<ExchangeAddress> |
文字列 ❸ | コンソールの Exchange デバイス アカウントのサインイン名。 ExchangeAddress が省略された場合、SkypeSignInAddress が自動的に再利用されることはありません。 | |
<DomainUsername> |
文字列❷ | コンソール デバイスのドメインとユーザー名 (Seattle\RainierConf など)。 | |
<Password> |
文字列 ❸ | パスワード パラメーターは、Skype for Business デバイス アカウントのサインインに使用するパスワードと同じです。 | |
<ConfigureDomain> |
文字列❷ | 複数のドメインをコンマで区切って表示することができます。 | |
<ModernAuthEnabled> |
ブール値 ❷ | 既定では無効になっています。 True に設定すると、Microsoft Teams Rooms アプリケーションは先進認証を使用してリソースに接続するだけで、基本認証にはフォールバックしません。 |
|
<TeamsMeetingsEnabled> |
ブール値 ❷ | First ❶ | 既定では無効になっています。 <SkypeMeetingsEnabled>と<TeamsMeetingsEnabled>が無効になっている場合は、XML ファイルの形式が正しくないと考えられますが、両方の設定を同時に有効にすることができます。 |
<SfbMeetingEnabled> |
ブール❸ | First ❶ | 既定では無効になっています。 |
<IsTeamsDefaultClient> |
ブール値 ❷ | First ❶ | 既定では有効になっています。 |
<WebexMeetingsEnabled> |
ブール値 ❷ | First ❶ | 既定では無効になっています。 True の場合、Cisco Webex 会議に直接ゲスト参加することが可能になります。 |
<ZoomMeetingsEnabled> |
ブール値 ❷ | First ❶ | 既定では無効になっています。 true の場合、Zoom 会議の直接ゲスト参加エクスペリエンスが有効になります。 |
<UseCustomInfoForThirdPartyMeetings> |
ブール値 ❷ | First ❶ | 既定では無効になっており、会議室のアカウント情報を使用してサードパーティの会議に参加します。 この値を True にすると、 <CustomDisplayNameForThirdPartyMeetings>と<CustomDisplayEmailForThirdPartyMeetings>の両方を指定する必要があります。 |
<CustomDisplayNameForThirdPartyMeetings> |
文字列 ❸ | First ❶ | サードパーティの会議に参加するには、ゲスト名を指定します。 サードパーティ サービスは、操作環境でこのデータを表示し、サービスに格納する場合があります。 |
<CustomDisplayEmailForThirdPartyMeetings> |
文字列 ❸ | First ❶ | サードパーティの会議に参加するために使用するゲストのメールアドレスを指定します。 サードパーティ サービスは、操作環境でこのデータを表示し、サービスに格納する場合があります。 |
<BluetoothAdvertisementEnabled> |
ブール値 ❷ | First ❶ | 既定では有効になっています。 |
<AutoAcceptProximateMeetingInvitations> |
ブール値 ❷ | First ❶ | True の場合は、近接性ベースの会議が自動的に承諾されます。 既定では無効になっています。 |
<AutoExitMeetingEnabled> |
ブール値 ❷ | First ❶ | true の場合、デバイスは会議に残っている最後の参加者である場合、会議を自動的に終了します。 既定では無効になっています。 |
<DualScreenMode> |
ブール値 ❷ | First ❶ | true の場合、2 画面表示モードが有効になります。 それ以外の場合、デバイスでは 1 画面表示モードが使用されます。 |
<DuplicateIngestDefault> |
ブール値 ❷ | First ❶ | True の場合、会議を終了しているときに、2 画面表示モードで両方の画面にコンテンツが表示されます。 |
<DisableTeamsAudioSharing> |
ブール値 ❷ | First ❶ | Teams 会議の会議参加者への HDMI オーディオ共有を無効にするには、true に設定します。 既定の設定は False です。 |
<FrontRowEnabled> |
ブール値 ❷ | First ❶ | 既定では有効になっています。 false の場合、フロント行は無効になります。 |
<DefaultFoRExperience> |
ブール値 ❷ | First ❶ | 既定ではギャラリー ビュー。 既定のレイアウトをギャラリー ビューからフロント 行に変更するには、1 を配置します。 |
<SingleFoRDefaultContentLayout> |
文字列 | 単一表示モードでは、Content+people と Content の間の既定のレイアウトのみを設定できます。
|
|
<EnablePublicPreview> |
ブール値 ❷ | First ❶ | 既定では無効になっています。 true の場合、パブリック プレビューが有効になり、エンド ユーザーは有効なTeams Roomsのパブリック プレビューの機能にアクセスできます。 詳細については、「Windows でのMicrosoft Teams Roomsのパブリック プレビュー」を参照してください。 |
<NoiseSuppressionDefault> |
文字列 | First ❶ | Teams のノイズ抑制レベルを制御します。
|
<CortanaWakewordEnabled> |
ブール値 ❷ | First ❶ | Cortana ウェイク ワード "Cortana さん" を有効にするには、true に設定します。 この設定は、Cortana サービスが国または地域でサポートされ、接続されているオーディオ周辺機器が Cortana をサポートしている場合を除き、何の効果も得られません。 既定の設定は False です。 |
<SendLogs> |
コンテナー | First ❶ | |
<EmailAddressForLogsAndFeedback> |
文字列 ❸ | [フィードバックの送信] ウィンドウが表示されたときにログの送信先となるオプションのメールアドレスを設定します。 | |
<SendLogsAndFeedback> |
ブール値 ❷ | True の場合、ログは管理者に送信されます。False の場合は、フィードバックのみが管理者に送信され、ログには送信されません。 | |
<Devices> |
コンテナー | First ❶ | 子要素内の接続済みのオーディオ デバイス名は、デバイス マネージャー アプリにリスト表示された値と同一のものになります。 この構成には、現在コンソールに接続していない A/V デバイスなど、現在システムに存在しないデバイスを含めることができます。 この構成はそれぞれのデバイスに対して保持されます。 |
<MicrophoneForCommunication> |
文字列 ❸ | 会議で録音デバイスとして使用されるマイクを設定します。 | |
<SpeakerForCommunication> |
文字列 ❸ | 会議でスピーカーとして使用するデバイス。 この設定では、通話で使用するスピーカー デバイスを設定します。 | |
<DefaultSpeaker> |
文字列 ❸ | HDMI 取り込みソースからのオーディオの再生に使用するデバイス。 | |
<ContentCameraId> |
文字列 ❸ | 会議でアナログのホワイトボード コンテンツを共有するために、会議室に構成されているカメラのインスタンス パスを定義します。 詳細については、「コンテンツ カメラの USB インスタンス パス」を参照してください。 | |
<ContentCameraInverted> |
ブール値 ❷ | コンテンツ カメラが物理的に上下逆さまに設置されているかどうかを指定します。 自動回転に対応したコンテンツ カメラの場合は、False を指定します。 | |
<ContentCameraEnhancement> |
ブール値 ❷ | True (既定) に設定すると、コンテンツ カメラの画像はデジタル機能が強化されます。ホワイトボードの端が検出され、適切な拡大率が選択されます。インクの線が強化され、ホワイトボードに書くユーザーが透明になります。 ホワイトボードにペンで書き込む代わりに、カメラを使って付箋、ポスターなどのメディアを表示することにスペースを活用して、会議参加者に未編集のビデオフィードを送信する場合は、False に設定します。 |
|
<Theming> |
コンテナー | First ❶ | XML ファイルを使用して適用できる機能の 1 つに、所属組織のカスタム テーマがあります。 テーマ名、背景画像、色を指定できます。 |
<ThemeName> |
文字列 ❸ | クライアントのテーマを特定するために使用されます。 テーマ名のオプションは、既定、提供されたプリセット テーマのいずれか、またはカスタムになります。 ユーザー設定のテーマ名は常に Custom という名前を使います。 クライアント UI は、コンソールで、既定またはプリセットのいずれかに設定できますが、ユーザー設定のテーマの使用は管理者によってリモートで設定する必要があります。 プリセット テーマには次のものが含まれます: 既定値 Blue Wave Digital Forest Dreamcatcher Limeade Pixel Perfect ロードマップ 終了する 現在の名前を無効にするには、ThemeName で [No Theme] を使用します。 |
|
<CustomThemeImageUrl> |
文字列 ❸ | ユーザー設定のテーマの場合は必須ですが、それ以外の場合は省略可能です。 ファイル名のみを入力します。 ユーザー設定のテーマ画像の詳細については、「ユーザー設定のテーマ画像」セクションを参照してください。 | |
<CustomThemeColor> |
コンテナー | <RedComponent>、<GreenComponent>、および<BlueComponent>値のコンテナー。 これらの値は必須ですが、テーマの色には影響しません。 0 ~ 255 の任意の値を指定してください。 |
|
<RedComponent> |
Byte (0-255) | 赤のカラー コンポーネントを表します。 | |
<GreenComponent> |
Byte (0-255) | 緑のカラー コンポーネントを表します。 | |
<BlueComponent> |
Byte (0-255) | 青のカラー コンポーネントを表します。 | |
<CoordinatedMeetings> |
ブール値 ❷ | First ❶ | 会議の最適化を構成する要素のコンテナー。 この要素は 1 つの属性を持っています。
|
<TrustedAccounts> |
文字列 | これは、デバイスが会議参加要求を受け入れる必要があるTeams Roomsデバイスまたは Surface Hub ごとに、または会議参加要求を送信する必要がある UPN のコンマ区切りの一覧です。 | |
<Settings> |
コンテナー | 会議を最適化するためにオーディオおよびビデオの構成要素を構成するためのコンテナー。 | |
<Audio> |
ブール値 ❷ | Teams ミーティング デバイスでオーディオ構成を制御します。 この要素には 2 つの属性があります。
|
|
<Video> |
ブール値 ❷ | Teams ミーティング デバイスのビデオ構成を制御します。 この要素には 2 つの属性があります。
|
|
<Whiteboard> |
ブール値 ❷ | Teams ミーティング デバイスのホワイトボード構成を制御します。 この要素には 2 つの属性があります。
|
|
<EnableResolutionAndScalingSetting> |
ブール値 ❷ | First ❶ | 既定では無効になっています。 Front of Room の解像度とスケーリングを変更する場合は、true に設定します。 true の場合、表示の解像度とスケールの設定が適用されます。 この設定が有効になると、メイン FoR と Extended FoR の両方に影響します。 |
<MainFoRDisplay> |
コンテナー | デバイスが単一表示モードを使用している場合は、このコンテナーを使用します。 デュアルディスプレイ モードでは、メイン フロント オブ ルーム (FoR) は、クロック (会議外) とセルフプレビュー ビデオ (会議中) を備えた画面です。 <MainFoRDisplayResolution> 一 <MainFoRDisplayScaling> 度に一緒に設定する必要があります。 どちらか一方<MainFoRDisplayResolution>``<MainFoRDisplayScaling>のみを使用する場合は無視されます。 |
|
<MainFoRDisplayResolution> |
文字列 | 幅、高さ (1920,1080 など) の入力数値。 FoR でサポートされていない場合は無視されます。 | |
<MainFoRDisplayScaling> |
数値 | スケーリングの数値を入力します。 有効な値は 100 (推奨)、125、150、175、200、225、250、300、350、400、450、500 です。 入力が 500 で、FoR が最大 300 をサポートしている場合は、300 に設定されます。 | |
<ExtendedFoRDisplay> |
コンテナー | デュアルディスプレイ モードでは、ルームの延長前面 (FoR) は、共有コンテンツ (会議中) を表示する画面です。 <ExtendedFoRDisplayResolution> 一 <ExtendedFoRDisplayScaling> 度に一緒に設定する必要があります。 どちらか一方<ExtendedFoRDisplayResolution>``<ExtendedFoRDisplayScaling>のみを使用する場合は無視されます。 |
|
<ExtendedFoRDisplayResolution> |
文字列 | Width、Height (1920,1080 など) の入力数値。 FoR が値をサポートしていない場合、値は無視されます。 | |
<ExtendedFoRDisplayScaling> |
数値 | スケーリングの数値を入力します。 有効な値は 100 (推奨)、125、150、175、200、225、250、300、350、400、450、500 です。 入力が 500 で、FoR が最大 300 をサポートしている場合は、300 に設定されます。 |
❶ 第 1 レベルの要素はすべて省略可能です。 第 1 レベルの要素が省略されると、その子要素はすべて変更されないままデバイス上に残ります。
❷ ブール値のフラグは、True、False、0、1 を指定できます。 ブール値や数値を空のままにしておくと、XML の形式が正しくない状態になり、設定を変更できなくなります。
❸ 3 文字列パラメーターが存在するが空であり、かつ空が有効な値である場合、デバイス上のパラメーターがクリアされます。
XML 構成ファイルを使用してコンソールの設定を管理する
起動時に、Microsoft Teams Rooms コンソールがC:\Users\Skype\AppData\Local\Packages\Microsoft.SkypeRoomSystem_8wekyb3d8bbwe\LocalStateにある SkypeSettings.xml という名前の XML ファイルを見つけると、XML ファイルで示される構成設定を適用し、XML ファイルを削除します。
所属する企業で何台の Microsoft Teams Rooms デバイスを所有しているか、およびそれらを構成するためにどのような方法を選択するかに応じて、XML 構成ファイルを配置する方法が複数あります。 ファイルがコンソールにプッシュされたら、再起動して構成の変更を処理します。 処理に成功すると、XML 構成ファイルが削除されます。 Microsoft Teams Rooms デバイスで推奨される管理方法は次のとおりです。
ファイルの転送と、コンソール デバイス上での再起動のトリガーができるのであれば、いずれの方法も使用できます。 ファイルは、デバイスのローカル ユーザー アカウントで読み取り、書き込み、削除が可能であることが必要です。 できれば、そのユーザーが所有し、完全な特権が与えられることがよいでしょう。 ファイルの権限が適切に設定されていない場合、ソフトウェアは設定の適用に失敗したり、処理成功時にファイルの削除に失敗する可能性があるだけではなく、クラッシュする可能性があります。
サポートされている会議モード アプリ バージョン 4.9
Skype for Business (既定) および Microsoft Teams
| XML 表記 | XML 値 |
|---|---|
<TeamsMeetingsEnabled> |
True |
<SfbMeetingEnabled> |
True |
<IsTeamsDefaultClient> |
False |
Skype for Business および Microsoft Teams (既定)
| XML 表記 | XML 値 |
|---|---|
<TeamsMeetingsEnabled> |
True |
<SfbMeetingEnabled> |
True |
<IsTeamsDefaultClient> |
True |
Skype for Business のみ
| XML 表記 | XML 値 |
|---|---|
<TeamsMeetingsEnabled> |
False |
<SfbMeetingEnabled> |
True |
<IsTeamsDefaultClient> |
False |
Microsoft Teams のみ
| XML 表記 | XML 値 |
|---|---|
<TeamsMeetingsEnabled> |
True |
<SfbMeetingEnabled> |
False |
<IsTeamsDefaultClient> |
True |
サポートされている会議モード アプリ バージョン 4.8 以降
Skype for Business (既定) および Microsoft Teams
| XML 表記 | XML 値 |
|---|---|
<TeamsMeetingsEnabled> |
True |
<IsTeamsDefaultClient> |
False |
Skype for Business および Microsoft Teams (既定)
| XML 表記 | XML 値 |
|---|---|
<TeamsMeetingsEnabled> |
True |
<IsTeamsDefaultClient> |
True |
Skype for Business のみ
| XML 表記 | XML 値 |
|---|---|
<TeamsMeetingsEnabled> |
False |
<IsTeamsDefaultClient> |
False |
ユーザー設定のテーマ画像
ユーザー設定のテーマ画像ファイルは、C:\Users\Skype\AppData\Local\Packages\Microsoft.SkypeRoomSystem_8wekyb3d8bbwe\LocalStateフォルダーに配置する必要があります。 <CustomThemeImageUrl>変数にファイル名と拡張子を入力します。
画像ファイルはちょうど 3840 x 1080 ピクセルであり、jpg、jpeg、png、bmp のいずれかの形式である必要があります。 組織でユーザー設定の画像が必要な場合、グラフィック デザイナーはユーザー設定のテーマ Photoshop テンプレートを使用できます。 このテンプレートには、テーマ画像の残りの部分に関連したユーザー インターフェースの要素や、コンソールやディスプレイに表示される領域に関する詳細が記載されています。
テーマ画像を認識するには、デバイスの起動時に XML 構成ファイルを更新する必要があります。 新しい XML ファイルが処理され、削除されると、テーマのグラフィック ファイルはディレクトリから削除されます。
コンテンツ カメラの USB インスタンス パスを検索する
インスタント パスを検索する方法を次に示します。
- Microsoft Teams Rooms コンソールの Windows 設定に移動します。
- 管理者パスワードを入力します。
- コマンドプロンプトで
devmgmt.mscを入力して、デバイス マネージャーを開きます。 - デバイス マネージャー で イメージング デバイス ノードを探し、コンテンツ カメラを見つけます。
- カメラを右クリックし、[プロパティ] を開きます。
- [詳細] タブを選び、ドロップダウンリストから [デバイス インスタンスパス] プロパティを見つけます。
- 表示される値は、XML 構成ファイルに設定するデバイス インスタンス パスです。 XML でパスを指定する場合は、アンパサンド (&) を
&に置き換えます。
フロント行を既定のレイアウトとして設定する
XML 構成でルームの既定の表示レイアウトを設定しない場合、既定のレイアウトはギャラリーに設定されます。 Front row を既定のレイアウトとして表示するには、XML 構成ファイルに追加 <DefaultFoRExperience>1</DefaultFoRExperience> します。
エンド ユーザーは、会議中にレイアウト ピッカーを使用して既定の表示レイアウトから切り替えることができます。
フロント行をオフにする
フロント行は既定で有効になっています。 エンド ユーザーが特定の部屋でフロント行を使用することを許可しない場合は、フロント行をオフにします。 これを行うには、XML 構成ファイルに追加 <FrontRowEnabled>false</FrontRowEnabled> します。
ルームのスケールと解像度の前面を設定する
Front of Room ディスプレイのスケールと解像度を設定するには、コンテナーを使用して XML 構成ファイルに<MainFoRDisplay>追加<EnableResolutionAndScalingSetting>true</EnableResolutionAndScalingSetting>します。 デバイスでデュアル ディスプレイを使用している場合は、コンテナーも含めます <ExtendedFoRDisplay> 。
単一の表示を使用してTeams Roomsに対して両方と<ExtendedFoRDisplay>コンテナーを一緒に使用<MainFoRDisplay>する<ExtendedFoRDisplay>場合、コンテナーは無視されます。 詳細については、上記の XML と要素の例の表を参照してください。