SurfaceHub 云解决方案提供商

SurfaceHub 配置服务提供程序 (CSP) 用于配置Microsoft Surface Hub设置。 此 CSP 已在 Windows 10 版本 1511 及更高版本中添加。

以下示例演示了树格式的 SurfaceHub CSP 管理对象。

./Vendor/MSFT
SurfaceHub
----DeviceAccount
--------DomainName
--------UserName
--------UserPrincipalName
--------Password
--------ValidateAndCommit
--------ExchangeServer
--------SipAddress
--------Email
--------CalendarSyncEnabled
--------ErrorContext
--------PasswordRotationEnabled
----MaintenanceHoursSimple
--------Hours
------------StartTime
------------Duration
----InBoxApps
--------SkypeForBusiness
------------DomainName
--------Welcome
------------AutoWakeScreen
------------CurrentBackgroundPath
------------MeetingInfoOption
--------Whiteboard
------------SharingDisabled
------------SigninDisabled
------------TelemeteryDisabled
--------WirelessProjection
------------PINRequired
------------Enabled
------------Channel
--------Connect
------------AutoLaunch
----Properties
--------FriendlyName
--------DefaultVolume
--------DefaultAutomaticFraming
--------ScreenTimeout
--------SessionTimeout
--------SleepTimeout
--------AllowSessionResume
--------AllowAutoProxyAuth
--------ProxyServers
--------DisableSigninSuggestions
--------DoNotShowMyMeetingsAndFiles
----Management
--------GroupName
--------GroupSid
----MOMAgent
--------WorkspaceID
--------WorkspaceKey

./Vendor/MSFT/SurfaceHub
Surface Hub 配置服务提供程序的根节点。

DeviceAccount 用于设置设备帐户信息的节点。 设备帐户是连接 Skype for Business 的 Microsoft Exchange 帐户,用户可以参加预定会议、拨打 Skype for Business 电话和从设备分享内容。 有关设置设备帐户的详细信息,请参阅 Surface Hub 管理员指南。

使用 Azure Active Directory 中的设备帐户

  1. 设置 Azure AD) 的 UserPrincipalName (。
  2. 设置有效的密码。
  3. 对 Azure AD 执行 ValidateAndCommit 以验证指定的用户名和密码组合。
  4. 如果验证过程中出现问题,请获取 ErrorContext。

备注

如果设备无法从此信息自动发现 Exchange 服务器和会话启动协议 (SIP) 地址,则应指定 ExchangeServer 和 SipAddress。

此处'SyncML 示例。

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Replace>
            <CmdID>1</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/UserPrincipalName</LocURI>
                </Target>
                <Meta>
                    <Format xmlns="syncml:metinf">chr</Format>
                </Meta>
                <Data>user@contoso.com</Data>
            </Item>
        </Replace>
        <Replace>
            <CmdID>2</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/Password</LocURI>
                </Target>
                <Meta>
                    <Format xmlns="syncml:metinf">chr</Format>
                </Meta>
                <Data>password</Data>
            </Item>
        </Replace>
        <Exec>
            <CmdID>3</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/ValidateAndCommit</LocURI>
                </Target>
            </Item>
        </Exec>
        <Get>
            <CmdID>4</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/ErrorContext</LocURI>
                </Target>
            </Item>
        </Get>
        <Final/>
    </SyncBody>
</SyncML>

若要使用 Active Directory 中的设备帐户,请执行以下操作:

  1. 设置 DomainName。
  2. 设置 UserName。
  3. 设置有效的密码。
  4. 执行 ValidateAndCommit 节点。

DeviceAccount/DomainName

使用 Active Directory 时设备帐户的域。 若要从 Active Directory 使用设备帐户,应指定设备帐户的 DomainName 和 UserName。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/UserName

使用 Active Directory 时设备帐户的用户名。 若要从 Active Directory 使用设备帐户,应指定设备帐户的 DomainName 和 UserName。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/UserPrincipalName

设备帐户的 UPN) (用户主体名称。 若要从 Azure Active Directory 或混合部署使用设备帐户,应指定设备帐户的 UPN。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/SipAddress

会话启动协议 (设备帐户的 SIP) 地址。 通常情况下,设备会尝试自动发现 SIP。 仅当自动发现失败时,才需要此字段。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/Password

设备帐户的密码。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。 允许执行 Get 操作,但始终返回空白。

DeviceAccount/ValidateAndCommit

此方法验证提供的数据,然后提交更改。

  • 数据类型为字符串。
  • 支持的操作为“执行”。

DeviceAccount/Email

设备帐户的电子邮件地址。 数据类型为字符串。

DeviceAccount/PasswordRotationEnabled

指定是否启用自动密码轮转。 如果对设备帐户强制实施密码过期策略,请使用此设置允许设备通过经常更改密码自行进行管理,而无需你在密码到期时手动更新帐户信息。 可以随时使用 Active Directory (或 Azure AD) 重置密码。

有效值:

  • 0 - 启用密码轮换
  • 1 - 已禁用

它执行以下操作:

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/ExchangeServer

设备帐户的 Exchange 服务器。 通常情况下,设备会尝试自动发现 Exchange 服务器。 仅当自动发现失败时,才需要此字段。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/ExchangeModernAuthEnabled

KB4598291 中添加了 Windows 10 版本 20H2。 指定设备帐户日历同步是否会尝试使用基于令牌的新式身份验证连接到Exchange Server。 默认值为 True。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/CalendarSyncEnabled

指定是否启用日历同步和其他 Exchange 服务器服务。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

DeviceAccount/ErrorContext

如果调用 ValidateAndCommit 时出错,则此节点中存在另一个此错误的上下文。 下面是可能的错误值:

ErrorContext 值 发生错误的阶段 说明和建议
1 Unknown
2 填充帐户 无法使用提供的用户名和密码检索帐户详细信息。

对于 Azure AD 帐户,请确保 UserPrincipalName 和 Password 有效。
对于 AD 帐户,请确保 DomainName、UserName 和 Password 有效。
确保指定的帐户具有 Exchange 服务器邮箱。
3 填充 Exchange 服务器地址 无法自动发现 Exchange 服务器地址。 尝试使用 ExchangeServer 字段手动指定 Exchange 服务器地址。
4 验证 Exchange 服务器地址 无法验证 Exchange 服务器地址。 确保 ExchangeServer 字段有效。
5 保存帐户信息 无法将帐户详细信息保存到系统。
6 验证 EAS 策略 设备帐户使用不受支持的 EAS 策略。 确保根据管理员指南正确配置 EAS 策略。

它执行以下操作:

  • 数据类型为整数。
  • 支持的操作为 Get。

MaintenanceHoursSimple/Hours 用于维护计划的节点。

MaintenanceHoursSimple/Hours/StartTime

指定从午夜开始的维护时间的开始时间(以分钟为单位)。 例如,若要设置凌晨 2:00 的开始时间,请将此值设置为 120。

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

MaintenanceHoursSimple/Hours/Duration

指定维护时段的持续时间(以分钟为单位)。 例如,若要设置 3 小时的持续时间,请将该值设置为 180。

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

InBoxApps

内置应用设置的节点。

InBoxApps/SkypeForBusiness

已添加到 Windows 10 版本 1703。 Skype for Business设置的节点。

InBoxApps/SkypeForBusiness/DomainName

已添加到 Windows 10 版本 1703。 指定使用 Active Directory 时Skype for Business帐户的域。 有关详细信息,请参阅“设置联机Skype for Business。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

InBoxApps/Welcome 欢迎屏幕的节点。

InBoxApps/Welcome/AutoWakeScreen

使用运动传感器自动打开屏幕。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

InBoxApps/Welcome/CurrentBackgroundPath

图像的下载位置,在用户会话期间和欢迎屏幕上用作背景。 若要设置此位置,请将 https URL 指定为 32 位 PNG 文件 (出于安全原因仅支持 PNG) 。 如果需要信任任何证书颁发机构才能访问 URL,请确保它们有效并安装在中心。 否则,它可能无法加载映像。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

InBoxApps/Welcome/MeetingInfoOption

欢迎屏幕上显示的会议信息。

有效值:

  • 0 - 仅限组织者和时间
  • 1 - 组织者、时间和主题。 主题隐藏在私人会议中。

它执行以下操作:

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

InBoxApps/Whiteboard

Whiteboard 应用设置的节点。

InBoxApps/Whiteboard/SharingDisabled

不允许从 Whiteboard 应用进行协作的邀请。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

InBoxApps/Whiteboard/SigninDisabled

不允许从 Whiteboard 应用登录。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

InBoxApps/Whiteboard/TelemeteryDisabled

不允许从 Whiteboard 应用收集遥测数据。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

InBoxApps/WirelessProjection

无线投影器应用设置的节点。

InBoxApps/WirelessProjection/PINRequired

用户必须向设备输入 PIN 到无线项目。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

InBoxApps/WirelessProjection/Enabled

支持无线投影到设备。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

InBoxApps/WirelessProjection/Channel

用于Miracast 操作的无线通道。 受支持的通道由 Wi-Fi 联盟 Wi-Fi Direct 规范定义。

兼容性
与所有区域中的所有 Miracast 发件人一起工作 1, 3, 4, 5, 6, 7, 8, 9, 10, 11
适用于所有区域中的所有 5ghz 乐队 Miracast 发件人 36, 40, 44, 48
适用于除日本以外的所有区域的所有 5ghz 乐队 Miracast 发件人 149, 153, 157, 161, 165

默认值为 255。 出于监管方面的考虑,如果频道配置不正确,则驱动程序将不会启动,或者将在错误的频道上广播, (发件人赢得'不会寻找) 。

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

InBoxApps/Connect

已添加到 Windows 10 版本 1703。 Connect 应用的节点。

InBoxApps/Connect/AutoLaunch

已添加到 Windows 10 版本 1703。 指定在启动投影时是否自动启动 Connect 应用。

如果此设置为 true,则会自动启动 Connect 应用。 如果为 false,则用户需要从中心的设置手动启动 Connect 应用。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

属性

设备属性的节点。

Properties/FriendlyName

设备的友好名称。 指定用户希望无线项目到设备时看到的名称。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

Properties/DefaultVolume

已添加到 Windows 10 版本 1703。 指定新会话的默认卷值。 允许的值为 0-100。 默认值为 45。

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

Properties/DefaultAutomaticFraming

KB5010415 中添加了 Windows 10 版本 20H2。 指定是否启用 Surface Hub 2 智能相机功能以自动缩放和保持用户在视频中居中。 默认值为 True。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

Properties/ScreenTimeout

已添加到 Windows 10 版本 1703。 指定中心屏幕关闭之前的分钟数。

下表显示了允许的值。

描述
0 从不超时
1 1 分钟
2 2 分钟
3 3 分钟
5 5 分钟 (默认)
10 10 分钟
15 15 分钟
30 30 分钟
60 1 小时
120 2 小时
240 4 小时

它执行以下操作:

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

Properties/SessionTimeout

已添加到 Windows 10 版本 1703。 指定会话超时之前的分钟数。

下表显示了允许的值。

描述
0 从不超时
1 1 分钟 (默认)
2 2 分钟
3 3 分钟
5 5 分钟
10 10 分钟
15 15 分钟
30 30 分钟
60 1 小时
120 2 小时
240 4 小时

它执行以下操作:

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

Properties/SleepTimeout

已添加到 Windows 10 版本 1703。 指定中心进入睡眠模式之前的分钟数。

下表显示了允许的值。

描述
0 从不超时
1 1 分钟
2 2 分钟
3 3 分钟
5 5 分钟 (默认)
10 10 分钟
15 15 分钟
30 30 分钟
60 1 小时
120 2 小时
240 4 小时

它执行以下操作:

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

Properties/SleepMode

在 Windows 10 版本 20H2 中添加。 指定 Surface Hub 的睡眠模式类型。

有效值:

  • 0 - 连接待机 (默认)
  • 1 - 休眠

它执行以下操作:

  • 数据类型为整数。
  • 支持的操作是“获取”和“替换”。

Properties/AllowSessionResume

已添加到 Windows 10 版本 1703。 指定是否允许在会话超时时恢复会话的功能。

如果此设置为 true, "则屏幕空闲时,欢迎屏幕上将提供“恢复会话" ”功能。 如果为 false,则屏幕空闲后,会话将自动清理,就像“已启动结束会话" 功能”一样。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

Properties/AllowAutoProxyAuth

已添加到 Windows 10 版本 1703。 指定是否使用设备帐户进行代理身份验证。

如果此设置为 true,则设备帐户将用于代理身份验证。 如果为 false,则使用单独的帐户。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

Properties/ProxyServers

KB4499162 中添加了 Windows 10 版本 1703。 指定代理服务器的主机名,以便在启用 AllowAutoProxyAuth) 之前自动向任何用户交互 (提供设备帐户凭据。 这是一个分号分隔的服务器名称列表 (FQDN) ,没有任何额外的前缀 (例如 https://) 。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

Properties/DisableSigninSuggestions

已添加到 Windows 10 版本 1703。 指定是否使用计划会议中的邀请者禁用登录对话框的自动填充。

如果此设置为 true,则不会填充登录对话框。 如果为 false,则对话框将自动填充。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

Properties/DoNotShowMyMeetingsAndFiles

已添加到 Windows 10 版本 1703。 指定是否禁"用“开始”菜单中的“我的会议和文件"”功能,该功能显示已登录用户'Office 365的会议和文件。

如果此设置为 true,则不会显示“我的会议和文件”功能。 如果为 false,则会显示“我的会议和文件”功能。

  • 数据类型为布尔值。
  • 支持的操作是“获取”和“替换”。

MOMAgent

Microsoft Operations Management Suite 的节点。

MOMAgent/WorkspaceID

标识用于收集数据的 Microsoft Operations Management Suite 工作区 ID 的 GUID。 将此 GUID 设置为空字符串以禁用 MOM 代理。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。

MOMAgent/WorkspaceKey

用于工作区身份验证的主键。

  • 数据类型为字符串。
  • 支持的操作是“获取”和“替换”。 Get 操作是允许的,但它始终返回空字符串。

配置服务提供程序参考