XML 구성 파일을 사용하여 원격으로 Microsoft Teams 룸 콘솔 설정 관리

  • 아티클
  • 적용 대상:
    Microsoft Teams

이 문서에서는 Microsoft Teams 룸 디바이스에서 사용하는 기본 설정의 원격 관리에 대해 설명합니다. 마스터 설정 파일을 만드는 방법과 필요에 따라 Teams 룸에 배치하는 방법에 대한 토론 링크에 대해 설명합니다.

마스터 XML 파일을 업데이트하고 원격 Teams 룸 디바이스에 복사본을 전송하여 Teams 룸의 기본 설정을 변경할 수 있습니다.

참고

일부 기능은 Microsoft Teams 룸 Pro 라이선스가 할당된 Teams 룸 장치에서만 사용할 수 있습니다. Microsoft Teams 룸 Pro가 필요한 기능을 확인하려면 Microsoft Teams 룸 라이선스를 참조하세요.

XML 구성 파일을 사용하여 콘솔 설정 관리

시작할 때 Microsoft Teams 룸 콘솔이 C:\Users\Skype\AppData\Local\Packages\Microsoft.SkypeRoomSystem_8wekyb3d8bbwe\LocalState에 있는 SkypeSettings.xml이라는 XML 파일을 찾으면 XML 파일에 표시된 구성 설정을 적용한 다음 XML 파일을 삭제합니다.

기업이 가지고 있는 Microsoft Teams 룸 디바이스의 수와 디바이스를 구성하기 위해 관리하는 방법에 따라 XML 구성 파일을 배치하는 여러 가지 방법이 있습니다. 파일이 콘솔에 푸시되면 다시 시작하여 구성 변경 내용을 처리합니다. XML 구성 파일이 성공적으로 처리되면 삭제됩니다. Microsoft Teams 룸 디바이스에 대해 제안된 관리 방법은 다음에서 설명합니다.

파일을 전송하고 콘솔 디바에스에서 다시 시작을 트리거하는 데 사용할 수 있는 한 원하는 방법을 사용할 수 있습니다. 디바이스의 로컬 사용자 계정으로 파일을 읽고, 쓸 수 있고, 삭제할 수 있어야 합니다. 디바이스의 로컬 사용자가 소유하고 모든 권한을 가지고 있는 것이 좋습니다. 파일 사용 권한이 올바르게 설정되지 않으면 소프트웨어가 설정을 적용하지 못할 수 있고, 성공적으로 처리하고 나서 파일을 삭제하지 못할 수 있으며, 작동이 중단될 수도 있습니다.

XML 구성 파일 만들기

모든 텍스트 편집기를 사용하여 설정 파일을 만들 수 있습니다. XML Elements 표는 이 샘플 SkypeSettings.xml(필수 파일 이름) 구성 파일에 표시된 요소가 설명되어 있습니다.

<SkypeSettings>
  <AutoScreenShare>1</AutoScreenShare>
  <HideMeetingName>0</HideMeetingName>
  <AutoExitMeetingEnabled>true</AutoExitMeetingEnabled>
  <AudioRenderDefaultDeviceVolume>50</AudioRenderDefaultDeviceVolume>
  <AudioRenderCommunicationDeviceVolume>50</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>false</SfbMeetingEnabled>
  <IsTeamsDefaultClient>true</IsTeamsDefaultClient>
  <WebExMeetingsEnabled>true</WebExMeetingsEnabled>
  <ZoomMeetingsEnabled>true</ZoomMeetingsEnabled>
  <BlueJeansMeetingsEnabled>true</BlueJeansMeetingsEnabled>
  <UseCustomInfoForThirdPartyMeetings>true</UseCustomInfoForThirdPartyMeetings>
  <CustomDisplayNameForThirdPartyMeetings>guestname</CustomDisplayNameForThirdPartyMeetings>
  <CustomDisplayEmailForThirdPartyMeetings>guest@microsoft.com</CustomDisplayEmailForThirdPartyMeetings>
  <BluetoothAdvertisementEnabled>true</BluetoothAdvertisementEnabled>
  <AutoAcceptProximateMeetingInvitations>true</AutoAcceptProximateMeetingInvitations>
  <AllowRoomRemoteEnabled>true</AllowRoomRemoteEnabled>
  <RoomQRcodeEnabled>true</RoomQRcodeEnabled>
  <QRCodeAutoAcceptProximateMeetingInvitations>true</QRCodeAutoAcceptProximateMeetingInvitations>
  <DualScreenMode>false</DualScreenMode>
  <DuplicateIngestDefault>true</DuplicateIngestDefault>
  <DisableTeamsAudioSharing>false</DisableTeamsAudioSharing>
  <EnableRoomCapacityNotification>true</EnableRoomCapacityNotification>
  <FrontRowEnabled>true</FrontRowEnabled>
  <FrontRowVideoSize>medium</FrontRowVideoSize>
  <FrontRowPanelDefaults>3,2</FrontRowPanelDefaults>
  <SingleFoRDefaultContentLayout>1</SingleFoRDefaultContentLayout>
  <DefaultFoRExperience>0</DefaultFoRExperience>
  <ShowMeetingChat>true</ShowMeetingChat>
  <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>
       <CustomBackgroundMainFoRDisplay>file name</CustomBackgroundMainFoRDisplay>
       <CustomBackgroundExtendedFoRDisplay>file name</CustomBackgroundExtendedFoRDisplay>
       <CustomBackgroundConsole>file name</CustomBackgroundConsole>
       <CustomThemeImageUrl>file name</CustomThemeImageUrl>
  </Theming>
  <TeamsRoomsNewExperience>true</TeamsRoomsNewExperience>
  <RemoveFoRCalendar>false</RemoveFoRCalendar>
  <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>  
  <EnableDeviceEndToEndEncryption>false</EnableDeviceEndToEndEncryption>
  <SplitVideoLayoutsDisabled>false</SplitVideoLayoutsDisabled>
</SkypeSettings>

변수 값이 잘못된 형식이거나, 요소가 순서가 잘못되거나, 요소가 닫히지 않았거나, 다른 오류가 발견되면 XML 파일의 형식이 잘못 형성됩니다. 잘못된 형식의 XML 파일을 처리하는 동안 오류가 발생하는 지점까지 설정이 발견되면 나머지 파일은 무시됩니다. XML의 알 수 없는 요소는 무시됩니다. 매개 변수를 생략하면 디바이스에서 변경되지 않은 상태로 유지됩니다. 매개 변수 값이 잘못된 경우 이전 값은 변경되지 않습니다.

XML 요소

요소 유형 수준 사용법
<SkypeSettings> 모든 요소에 대한 컨테이너. 필수 요소.
<AutoScreenShare> 부울 ❷ 첫 번째 ❶ true이면 자동 화면 공유가 사용됩니다.
<HideMeetingName> 부울 ❷ 첫 번째 ❶ true이면 모임 이름이 숨겨집니다.
<UserAccount> 컨테이너 첫 번째 ❶ 자격 증명 매개 변수에 대한 컨테이너. 로그인 주소, Exchange 주소 또는 전자 메일 주소는 일반적으로 RainierConf@contoso.com와 같이 동일합니다.
<SkypeSignInAddress> 문자열 ❷ 콘솔의 SfB 또는 Teams 장치 계정에 대한 로그인 이름입니다.
<ExchangeAddress> 문자열 ❸ 콘솔의 Exchange 장치 계정에 대한 로그인 이름입니다. ExchangeAddress를 생략하면 SkypeSignInAddress가 자동으로 다시 사용되지 않습니다.
<DomainUsername> 문자열 ❷ 콘솔 디바이스의 도메인 및 사용자 이름(예: Seattle\RainierConf)입니다.
<Password> 문자열 ❸ 암호 매개 변수는 비즈니스용 Skype 장치 계정 로그인에 사용되는 암호와 동일합니다.
<ConfigureDomain> 문자열 ❷ 여러 도메인을 쉼표로 구분하여 나열할 수 있습니다.
<ModernAuthEnabled> 부울 ❷ 기본적으로 사용하지 않도록 설정되어 있습니다.

true로 설정하면 Microsoft Teams 룸 애플리케이션은 최신 인증만 사용하여 리소스에 연결하고 기본 인증으로 돌아가지 않습니다.
<TeamsMeetingsEnabled> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정되어 있습니다.

XML 파일은 <SkypeMeetingsEnabled> 및 <TeamsMeetingsEnabled> 둘 다 사용하지 않도록 설정된 경우 잘못된 형식으로 간주되지만 두 설정을 동시에 사용하도록 설정하는 것이 허용됩니다.
<SfbMeetingEnabled> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정되어 있습니다.
<IsTeamsDefaultClient> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하도록 설정되어 있습니다.
<WebExMeetingsEnabled> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정되어 있습니다.

true이면 Cisco Webex 모임에 대한 직접 게스트 참가 환경을 사용하도록 설정합니다.
<ZoomMeetingsEnabled> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정되어 있습니다.

true이면 Zoom 모임에 대한 직접 게스트 참가 환경을 사용하도록 설정합니다.
<BlueJeansMeetingsEnabled> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정되어 있습니다.

true이면 BlueJeans 모임에 대한 직접 게스트 참가 환경을 사용하도록 설정합니다.
<UseCustomInfoForThirdPartyMeetings> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정되며 회의실 계정 정보를 사용하여 타사 모임에 참가합니다.

이 값이 true로 설정된 경우 <CustomDisplayNameForThirdPartyMeetings>, <CustomDisplayEmailForThirdPartyMeetings>를 모두 지정해야 합니다.
<CustomDisplayNameForThirdPartyMeetings> 문자열 ❸ 첫 번째 ❶ 타사 모임에 참가하는 데 사용되는 게스트 이름을 지정합니다. 타사 서비스는 이 데이터를 해당 환경에 표시하며 해당 서비스에 저장할 수 있습니다.
<CustomDisplayEmailForThirdPartyMeetings> 문자열 ❸ 첫 번째 ❶ 타사 모임에 참가하는 데 사용되는 게스트 이메일을 지정합니다. 타사 서비스는 이 데이터를 해당 환경에 표시하며 해당 서비스에 저장할 수 있습니다.
<BluetoothAdvertisementEnabled> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하도록 설정되어 있습니다.
<AutoAcceptProximateMeetingInvitations> 부울 ❷ 첫 번째 ❶ true이면 Bluetooth를 통한 근접 기반 모임 초대가 자동으로 수락됩니다. 기본적으로 사용하도록 설정되어 있습니다.
<AllowRoomRemoteEnabled> 부울 ❷ 첫 번째 ❶ true이면 회의실 원격 연결이 허용됩니다. 기본적으로 사용하도록 설정되어 있습니다.
<RoomQRcodeEnabled> 부울 ❷ 첫 번째 ❶ true이면 홈 화면에 QR 코드가 표시됩니다. 사용자는 QR 코드를 스캔하여 회의실 시스템과 빠르게 모임에 참가할 수 있습니다. 기본적으로 사용하도록 설정되어 있습니다. 자세한 내용은 QR 코드로 모임 참가를 참조하세요.
<QRCodeAutoAcceptProximateMeetingInvitations> 부울 ❷ 첫 번째 ❶ true이면 QR 코드를 통한 근접 기반 모임 초대가 자동으로 수락됩니다. 기본적으로 사용하도록 설정되어 있습니다. 자세한 내용은 QR 코드로 모임 참가를 참조하세요.
<AutoExitMeetingEnabled> 부울 ❷ 첫 번째 ❶ true이면 디바이스가 모임에 남아 있는 사용자가 마지막 참가자인 경우 자동으로 모임을 종료합니다. 기본적으로 사용하지 않도록 설정되어 있습니다.
<DualScreenMode> 부울 ❷ 첫 번째 ❶ true이면 이중 화면 모드가 사용됩니다. 그렇지 않으면 디바이스가 단일 화면 모드를 사용합니다.
<DuplicateIngestDefault> 부울 ❷ 첫 번째 ❶ true이면 모임에서 나갔을 때 이중 화면 모드에서 두 화면 모두에 콘텐츠가 표시됩니다.
<DisableTeamsAudioSharing> 부울 ❷ 첫 번째 ❶ Teams 모임에서 모임 참가자에게 HDMI 오디오 공유를 사용하지 않도록 설정하려면 true로 설정합니다. 기본 설정은 거짓입니다.
<EnableCloudIntelliframe> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하도록 설정되어 있습니다. true이면 Team 룸에 클라우드 IntelliFrame을 사용하도록 설정됩니다.
<EnableRoomCapacityNotification> 부울 ❷ 첫 번째 ❶ 회의실 참가자에게 회의실 용량에 도달했다는 경고를 제공하기 위해 기본적으로 사용하도록 설정됩니다(이를 위해서는 Exchange에서 회의실 용량을 설정하고 사용자를 셀 수 있는 카메라를 설정해야 함). 이러한 경고를 사용하지 않도록 설정하려면 false로 설정합니다.
<FrontRowEnabled> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하도록 설정되어 있습니다. false이면 앞줄을 사용할 수 없습니다. 자세한 내용은 앞줄을 기본 레이아웃으로 설정을 참조하세요.
<FrontRowVideoSize> 문자열 원격 참가자 비디오 및 공유 콘텐츠에 대한 공간을 더 많거나 적게 제공하도록 앞 행의 크기를 설정할 수 있습니다. 가능한 값은 small, medium 및 large 입니다. 기본값은 medium입니다. 자세한 내용은 앞줄을 기본 레이아웃으로 설정을 참조하세요.
<FrontRowPanelDefaults> 문자열 회의실 앞 디스플레이의 모임 콘텐츠 왼쪽과 오른쪽에 있는 모임 패널에서 손 들기 및 채팅 구성 요소의 위치를 구성할 수 있습니다.

손 들기 및 채팅 구성 요소의 위치를 수동으로 구성하려면 왼쪽 및 오른쪽 패널에 각각 표시되어야 하는 구성 요소의 숫자 값을 쉼표(예: 3,1)로 구분하여 지정합니다. 1 패널 숨기기를 제외하고 동일한 구성 요소를 사용하는 패널은 무시됩니다.
  • 1 패널을 숨깁니다.
  • 2 모임 채팅을 표시합니다.
  • 3 손 들기 목록을 표시합니다.

이중 디스플레이 모드에서 FrontRowPanelDefaults을(를) 지정하지 않으면 왼쪽 패널에 손 올리기 구성 요소가 표시되고 채팅 구성 요소가 오른쪽 패널에 표시됩니다. 단일 디스플레이 모드에서는 룸 앞면 디스플레이의 왼쪽 패널이 기본적으로 21:9보다 좁게 표시되지 않습니다.
<DefaultFoRExperience> 부울 ❷ 첫 번째 ❶ 기본적으로 갤러리 보기입니다. 갤러리 보기에서 앞 행으로 기본 레이아웃을 변경하려면 1을 입력합니다. 자세한 내용은 앞줄을 기본 레이아웃으로 설정을 참조하세요.
<EnableResolutionAndScalingSetting> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정됩니다. 룸의 앞의 해상도와 배율 조정을 변경하려면 true로 설정합니다. true이면 디스플레이 해상도 및 배율 설정이 적용됩니다. 이 설정은 사용하도록 설정되면 Main FoR 및 Extended FoR 모두에 영향을 줍니다. 자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<MainFoRDisplay> 컨테이너 첫 번째 ❶ 디바이스에서 단일 디스플레이 모드를 사용하는 경우 이 컨테이너를 사용합니다.

이중 디스플레이 모드에서 FoR(Main Front of Room) 디스플레이는 회의실 일정이 표시되는 화면입니다. 이 화면은 오른쪽에 설치됩니다. <MainFoRDisplayResolution> 및 는 <MainFoRDisplayScaling> 동시에 함께 설정되어야 합니다. <MainFoRDisplayResolution> 또는 <MainFoRDisplayScaling>만 사용하는 경우 무시됩니다. 자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<MainFoRDisplayResolution> 문자열 Width, Height(예: 1920,1080 또는 3840,2160)의 입력 숫자 값입니다. FoR에서 지원하지 않는 경우 무시됩니다. 자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<MainFoRDisplayScaling> 숫자 크기 조정의 입력 숫자 값입니다. 유효한 값은 100(권장), 125, 150, 175, 200, 225, 250, 300, 350, 400, 450 및 500입니다. 500을 입력하고 FoR이 최대 300을 지원하는 경우 300으로 설정됩니다. 자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<ExtendedFoRDisplay> 컨테이너 첫 번째 ❶ 이중 디스플레이 모드에서 FoR(확장 전면) 디스플레이는 날짜, 시간 및 회의실 정보가 표시되는 화면입니다. 이 화면은 왼쪽에 설치됩니다. <ExtendedFoRDisplayResolution> 및 는 <ExtendedFoRDisplayScaling> 동시에 함께 설정되어야 합니다. <ExtendedFoRDisplayResolution> 또는 <ExtendedFoRDisplayScaling>만 사용하는 경우 무시됩니다. 자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<ExtendedFoRDisplayResolution> 문자열 Width, Height(예: 1920,1080 또는 3840,2160)의 입력 숫자 값입니다. FoR에서 지원하지 않는 경우 값은 무시됩니다. 자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<ExtendedFoRDisplayScaling> 숫자 크기 조정의 입력 숫자 값입니다. 유효한 값은 100(권장), 125, 150, 175, 200, 225, 250, 300, 350, 400, 450 및 500입니다. 500을 입력하고 FoR이 최대 300을 지원하는 경우 300으로 설정됩니다. 자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<SingleFoRDefaultContentLayout> 문자열 단일 디스플레이 모드에서는 콘텐츠+사용자와 콘텐츠만 중에 기본 레이아웃을 설정할 수 있습니다.
  • 0 콘텐츠만
  • 1 콘텐츠+사용자(기본값)

자세한 내용은 Teams 룸 디스플레이의 레이아웃, 크기 조정 및 해상도 원격 구성을 참조하세요.
<ShowMeetingChat> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하도록 설정되어 있습니다. 사용하지 않도록 설정된 경우 Teams 룸 디바이스의 모임 레이아웃에서 모임 채팅 기능(채팅 거품 및 채팅 선택 포함)을 사용할 수 없습니다.
<OpenMeetingChatByDefault> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하도록 설정되어 있습니다. 사용하지 않도록 설정하면 채팅 패널이 갤러리 보기를 사용하여 모임에 기본적으로 표시되지 않습니다.
<EnablePublicPreview> 부울 ❷ 첫 번째 ❶ 기본적으로 사용하지 않도록 설정되어 있습니다. true이면 공개 미리 보기가 활성화되고 최종 사용자가 활성화된 Teams 룸에서 공개 미리 보기의 기능에 액세스할 수 있습니다. 자세한 내용은 Windows에서 Microsoft Teams 룸에 대한 공개 미리 보기를 참조하세요.
<NoiseSuppressionDefault> 문자열 첫 번째 ❶ Teams에서 노이즈 억제 수준을 제어합니다.
  • 0 꺼져 있습니다. OEM에서 제공하는 노이즈 억제만 사용합니다.
  • 1 높습니다. 음성이 아닌 모든 배경 소음(고정 및 비정형)을 표시하지 않습니다.
<SendLogs> 컨테이너 첫 번째 ❶
<EmailAddressForLogsAndFeedback> 문자열 ❸ 문제 보고를 사용하여 제출된 로그 및 피드백을 받는 이메일 주소를 설정합니다.
<SendLogsAndFeedback> 부울 ❷ 문제를 보고하여 제출된 피드백과 함께 로그를 보낼 수 있습니다. 더 큰 크기의 로그 및 피드백이 전달되도록 하려면 Exchange 관리 센터에서 사서함에 대한 메시지 크기 제한을 조정합니다.
<Devices> 컨테이너 첫 번째 ❶ 자식 요소의 연결된 오디오 디바이스 이름은 장치 관리자 앱에 나열된 값과 동일합니다. 구성에는 현재 시스템에 존재하지 않는 A/V 디바이스와 같이 현재 콘솔에 연결되어 있지 않은 디바이스가 포함될 수 있습니다. 구성은 해당 디바이스에 대해 유지됩니다.
<MicrophoneForCommunication> 문자열 ❸ 회의에서 녹음 장치로 사용되는 마이크를 설정합니다.
<SpeakerForCommunication> 문자열 ❸ 회의의 스피커로 사용할 디바이스입니다. 이 설정은 통화에 사용되는 스피커 디바이스를 설정하는 데 사용됩니다.
<DefaultSpeaker> 문자열 ❸ HDMI 수집 소스에서 오디오를 재생하는 데 사용할 장치입니다.
<ContentCameraId> 문자열 ❸ 모임에서 아날로그 화이트보드 콘텐츠를 공유하도록 룸에 구성된 카메라의 인스턴스 경로를 정의합니다. 콘텐츠 카메라 USB 인스턴스 경로 찾기를 참조하세요.
<ContentCameraInverted> 부울 ❷ 콘텐츠 카메라가 물리적으로 설치되어 있는지를 지정합니다. 자동 회전을 지원하는 콘텐츠 카메라의 경우 false를 지정합니다.
<ContentCameraEnhancement> 부울 ❷ true(기본값)로 설정하면 콘텐츠 카메라 이미지가 디지털 방식으로 향상됩니다. 화이트보드 가장자리가 탐색되고 적절한 확대/축소가 선택되고, 잉크 선이 향상되고, 화이트보드에 쓰는 사람이 투명해집니다.

모임 참가자에게 화이트보드가 펜으로 그려지지 않고 접착 노트, 포스터 또는 기타 미디어를 표시하는 데 카메라가 사용되는 원시 비디오 피드를 보내려는 경우 false로 설정합니다.
<Theming> 컨테이너 첫 번째 ❶ XML 파일에 적용할 수 있는 기능 중 하나는 조직의 사용자 지정 테마입니다. 테마 이름, 배경 이미지 및 색을 지정할 수 있습니다.
<ThemeName> 문자열 ❸ 클라이언트에서 테마를 식별하는 데 사용됩니다. 테마 이름 옵션은 제공된 미리 설정된 테마 중 하나 Vivid Flag Default 또는 Custom입니다.

사용자 지정 테마 이름은 항상 Custom 이름을 사용합니다. 클라이언트 UI는 콘솔에서 기본값 또는 사전 설정 중 하나로 설정할 수 있지만 관리자가 사용자 지정 테마를 원격으로 설정해야 합니다.
미리 설정된 테마는 다음과 같습니다.
Vivid Flag Default
Summer Summit
Seaside Bliss
Into The Fold
Creative Conservatory
Default
Blue Wave
Digital Forest
Dreamcatcher
Limeade
Pixel Perfect
Roadmap
Sunset
현재 테마를 사용하지 않도록 설정하려면 No Theme을 <ThemeName>에 사용합니다.
<CustomBackgroundMainFoRDisplay> 문자열 ❸ Microsoft Teams 룸 Pro 라이선스를 사용하여 Teams 룸 버전 4.17 이상에서 기본/오른쪽 사용자 지정 배경 이미지의 파일 이름을 지정하는 데 사용됩니다.

<ThemeName>이(가) Custom로 설정된 경우 필수입니다.

자세한 내용은 Windows 4.17 이상 사용자 지정 배경에서 Teams 룸 설정 및 관리를 참조하세요.
<CustomBackgroundExtendedFoRDisplay> 문자열 ❸ Microsoft Teams 룸 Pro 라이선스를 사용하여 Teams 룸 버전 4.17에서 확장/왼쪽 사용자 지정 배경 이미지의 파일 이름을 지정하는 데 사용됩니다.

<ThemeName>(이)가 Custom그리고<DualScreenMode>(이)가 true(으)로 설정된 경우 필수입니다.

자세한 내용은 Windows의 Teams 룸 설정 및 관리 고급 사용자 지정 배경을 참조하세요.
<CustomBackgroundConsole> 문자열 ❸ Microsoft Teams 룸 Pro 라이선스를 사용하여 Teams 룸 버전 4.17 이상에서 터치 콘솔 사용자 지정 배경 이미지의 파일 이름을 지정하는 데 사용됩니다.

선택 요소입니다.

자세한 내용은 Windows의 Teams 룸 설정 및 관리 고급 사용자 지정 배경을 참조하세요.
<CustomThemeImageUrl> 문자열 ❸ Teams 룸 버전 4.16 이하 또는 Microsoft Teams 룸 기본 라이선스가 있는 장치에서 사용자 지정 테마 이미지 파일 이름을 지정하는 데 사용됩니다. 파일 이름만 입력합니다. 사용자 지정 테마에 대한 자세한 내용은 Windows 표준 사용자 지정 배경에서 Teams 룸 설정 및 관리를 참조하세요.

Teams 룸 버전 4.17 이상에서는 <CustomBackgroundMainFoRDisplay>, <CustomBackgroundExtendedFoRDisplay> 및 <CustomBackgroundConsole> 요소를 사용하는 것이 좋습니다.
<TeamsRoomsNewExperience> 부울 ❷ 룸 앞 디스플레이 및 콘솔에서 새로 고친 홈 화면 디자인을 사용하거나 사용하지 않도록 설정합니다. 버전 4.17부터 새로 고친 홈 화면 디자인은 기본적으로 사용하도록 설정됩니다. 자세한 내용은 Microsoft Teams 룸 홈 화면 디자인 새로고침을 참조하세요.
<RemoveFoRCalendar> 부울 ❷ 룸 앞 디스플레이에서 달력을 제거합니다. 기본적으로 사용하지 않도록 설정되어 있습니다. 자세한 내용은 Microsoft Teams 룸 홈 화면 디자인 새로고침을 참조하세요.
<CoordinatedMeetings> 부울 ❷ 첫 번째 ❶ 조정된 모임의 구성 요소에 대한 컨테이너입니다. 이 요소에는 하나의 특성이 있습니다.
  • 사용은 Teams가 다른 장치와 함께 조정된 모임에 참여하도록 구성되어 있는지 여부를 결정합니다.
<TrustedAccounts> 문자열 각 Teams 룸 장치 또는 디바이스 혹은 모임 참가 요청을 수락하거나 모임 참가 요청을 보내야 하는 Surface Hub 대한 쉼표로 구분된 UPN 목록입니다.
<Settings> 컨테이너 조정된 모임의 오디오 및 비디오 구성 요소에 대한 컨테이너입니다.
<Audio> 부울 ❷ Teams 룸 디바이스에서 오디오 구성을 제어합니다. 이 요소에는 두 개의 특성이 있습니다.
  • 기본은 모임이 시작될 때 마이크가 활성화될 장치를 결정합니다. 하나의 장치(일반적으로 Teams 룸 장치)만 이 필드를 true(으)로 설정할 수 있지만 나머지 장치는 오디오 에코 및 피드백을 방지하기 위해 이 필드를 false(으)로 설정해야 합니다.
  • 사용은 모임 참가자가 마이크를 켜거나 끌 수 있는지 여부를 결정합니다. 오디오 기본으로 false 설정된 디바이스는 참가자가 실수로 마이크를 켜고 오디오 에코 또는 피드백을 발생시킬 수 없도록 이 설정을 false(으)로 설정해야 합니다.

    오디오 기본이 true(으)로 설정되면 오디오 사용 설정이 무시되고 참가자가 마이크를 음소거하거나 음소거 해제할 수 있습니다.
<Video> 부울 ❷ Teams 룸 디바이스에서 비디오 구성을 제어합니다. 이 요소에는 두 개의 특성이 있습니다.
  • 기본은 모임이 시작될 때 카메라가 활성화될 장치를 결정합니다. 최상의 환경을 위해 Teams 룸 장치만 true(으)로 설정하지만 다른 모든 장치는 false(으)로 설정하는 것이 좋습니다.
  • 사용 모임 참가자가 카메라를 켜거나 끌 수 있는지 여부를 결정합니다. 참가자가 Surface Hub 화이트보드를 사용하는 경우와 같이 다른 비디오 관점을 공유하려는 이벤트 참가자의 다른 장치에서 true(으)로 설정할 수 있습니다. 참가자가 장치에서 카메라를 켜거나 끌 수 없도록 하려면 false(으)로 설정하세요.

    비디오 기본이 true(으)로 설정되면 비디오 사용 설정이 무시되고 참가자는 카메라를 켜거나 끌 수 있습니다.
<Whiteboard> 부울 ❷ Teams 룸 디바이스에서 화이트보드 구성을 제어합니다. 이 요소에는 두 개의 특성이 있습니다.
  • 기본은 모임이 시작될 때 화이트보드가 활성화될 디바이스를 결정합니다. 최상의 환경을 위해 Teams 룸 장치를 false(으)로 설정하고 Surface Hub 화이트보드를 사용하는 것이 좋습니다.
  • 사용은 모임 참가자가 화이트보드를 켜거나 끌 수 있는지 여부를 결정합니다. 참가자가 디바이스에서 화이트보드를 켜거나 끄지 않도록 하려면 false(으)로 설정하세요.

    화이트모드 기본이 true로 설정되면 Whiteboard 사용 설정이 무시되고 참가자는 Whiteboard를 켜거나 끌 수 있습니다.
<EnableDeviceEndToEndEncryption> 부울 ❷ 기본값은 false입니다. 1:1 Teams 통화에 엔드 투 엔드 암호화를 사용하도록 설정하려면 true을(를) 지정합니다. 호출자와 받는 사람 모두 이 작업을 수행하려면 엔드 투 엔드 암호화를 사용하도록 설정해야 합니다.
<SplitVideoLayoutsDisabled> 부울 ❷ 기본값은 false입니다. 이 설정은 이중 디스플레이 룸에만 적용됩니다. 두 화면에서 비디오 갤러리 분할을 사용하지 않도록 설정하려면 true을(를) 지정합니다. 앞 행 레이아웃 및 앞 행 레이아웃과 관련된 모든 설정이 사용하지 않도록 설정됩니다.

❶ 1단계 요소는 모두 선택 사항입니다. 첫 번째 수준 요소를 생략하면 모든 자식 매개 변수가 디바이스에서 변경되지 않은 상태로 유지됩니다.

❷ 부울 플래그는 true, false, 0 또는 1일 수 있습니다. 부울 또는 숫자 값을 비워 두면 XML 형식이 잘못 렌더링되고 설정 변경이 방지될 수 있습니다.

❸ 문자열 매개 변수가 있고, 비어 있고, 비어 있는 값이 유효한 경우 디바이스에서 매개 변수가 지워집니다.

지원되는 모임 모드 앱 버전 4.9

비즈니스용 Skype(기본값) 및 Microsoft Teams

XML 표기법 XML 값
<TeamsMeetingsEnabled> True
<SfbMeetingEnabled> True
<IsTeamsDefaultClient> False

비즈니스용 Skype 및 Microsoft Teams(기본값)

XML 표기법 XML 값
<TeamsMeetingsEnabled> True
<SfbMeetingEnabled> True
<IsTeamsDefaultClient> True

비즈니스용 Skype만 해당

XML 표기법 XML 값
<TeamsMeetingsEnabled> False
<SfbMeetingEnabled> True
<IsTeamsDefaultClient> False

Microsoft Teams 전용

XML 표기법 XML 값
<TeamsMeetingsEnabled> True
<SfbMeetingEnabled> False
<IsTeamsDefaultClient> True

지원되는 모임 모드 앱 버전 4.8 이하

비즈니스용 Skype(기본값) 및 Microsoft Teams

XML 표기법 XML 값
<TeamsMeetingsEnabled> True
<IsTeamsDefaultClient> False

비즈니스용 Skype 및 Microsoft Teams(기본값)

XML 표기법 XML 값
<TeamsMeetingsEnabled> True
<IsTeamsDefaultClient> True

비즈니스용 Skype만 해당

XML 표기법 XML 값
<TeamsMeetingsEnabled> False
<IsTeamsDefaultClient> False

콘텐츠 카메라 USB 인스턴스 경로 찾기

인스턴스 경로를 찾으려면 다음을 수행합니다.

  1. Microsoft Teams 룸 콘솔에서 Windows 설정으로 이동합니다.
  2. 관리자 암호를 입력합니다.
  3. 명령 프롬프트에서 devmgmt.msc을(를) 입력하여 장치 관리자를 표시합니다.
  4. 장치 관리자에서 이미징 디바이스 노드를 보고 콘텐츠 카메라를 찾습니다.
  5. 카메라를 마우스 오른쪽 단추를 클릭하고 속성을 엽니다.
  6. 세부 정보 탭을 선택하고 드롭다운에서 디바이스 인스턴스 경로 속성을 찾습니다.
  7. 표시되는 값은 XML 구성 파일에 설정할 디바이스 인스턴스 경로입니다. XML에서 경로를 지정할 때 앰퍼샌드(&)를 로 바 &amp;꿉니다.

참고 항목

콘텐츠 카메라

Microsoft Teams 룸 관리

파일 항목 구성