服务器属性

Last published : Oct 21, 2026
服务器属性是全局属性，适用于整个 Citrix Endpoint Management 实例中的操作、用户和设备。Citrix 建议您评估本文中涵盖的服务器属性以适应您的环境。在更改其他服务器属性之前，请务必咨询 Citrix。
要更新服务器属性，请转至 设置 > 服务器属性。
Related information
思杰端点管理部署

添加、编辑或删除服务器属性

在 Citrix Endpoint Management 中，您可以将属性应用于服务器。
  1. 在 Citrix Endpoint Management 控制台中，单击右上角的齿轮图标。将显示 设置 页面。
  2. 在 服务器 下，单击 服务器属性。将显示 服务器属性 页面。您可以从此页面添加、编辑或删除服务器属性。
    服务器属性

添加服务器属性

  1. 单击 添加。将显示 添加新服务器属性 页面。
    服务器属性
  2. 配置以下设置：
    • 密钥：在列表中，选择相应的密钥。密钥区分大小写。在编辑属性值或请求特殊密钥之前，请联系 Citrix 支持。
    • 值：根据您选择的密钥输入一个值。
    • 显示名称：为新属性值输入一个名称，该名称将显示在 服务器属性 表中。
    • 描述：可选，输入新服务器属性的描述。
  3. 点击 保存。

编辑服务器属性

  1. 在 服务器属性 表中，选择要编辑的服务器属性。
    当您选择服务器属性旁边的复选框时，选项菜单会显示在服务器属性列表上方。单击列表中的其他任意位置可在列表右侧打开选项菜单。
  2. 点击 编辑。将显示 编辑新服务器属性 页面。
    服务器属性
  3. 根据需要更改以下信息：
    • 键：您无法更改此字段。
    • 值：属性值。
    • 显示名称：属性名称。
    • 描述：属性描述。
  4. 点击 保存 以保存更改，或点击 取消 以保持属性不变。

删除服务器属性

  1. 在 服务器属性 表中，选择要删除的服务器属性。
  2. 点击“删除”。出现确认对话框。再次点击“删除”。

服务器属性定义

访问托管 Google Play 商店中的所有应用程序

  • 如果为 true，Citrix Endpoint Management 会使公共 Google Play 商店中的所有应用程序都可从托管 Google Play 商店访问。您可以使用 (/zh-cn/citrix-endpoint-management/policies/restrictions-policy.html#android-enterprise-settings) 来控制对这些应用程序的访问。默认为 false。

始终添加设备

  • 如果为 true，Citrix Endpoint Management 会将设备添加到 Citrix Endpoint Management 控制台，即使设备注册失败。因此，您可以查看哪些设备尝试注册。默认为 false。

AG 客户端证书颁发限制间隔

  • 生成证书之间的宽限期。此间隔可防止 Citrix Endpoint Management 在短时间内为设备生成大量证书。Citrix 建议您不要更改此值。默认为 30 分钟。

允许删除在指定时间段内标记为非活动状态的设备

  • 如果为 true，在指定时间（以天为单位）内处于非活动状态的设备将从 Citrix Endpoint Management 中删除。活动期限由“设备在从 CEM 自动删除之前可以处于非活动状态的时间长度”服务器属性设置。默认为 true。要更改此属性的值，请咨询您的 Citrix 代表。

审计日志记录器

  • 如果为 False，不记录用户界面 (UI) 事件。默认为 False。

阻止已 Root 的 Android 设备和已越狱的 iOS 设备注册

当此属性设置为 true 时，Citrix Endpoint Management 会阻止已 Root 的 Android 设备和已越狱的 iOS 设备的注册。建议所有安全级别都设置为 true。默认为 true。

cdn.s3.retry.interval 和 cdn.s3.max.retry

服务器属性 cdn.s3.retry.interval 和 cdn.s3.max.retry 协同工作，为每个 macOS PKG 文件上传设置最大时间限制。默认情况下，Citrix Endpoint Management 将文件上传时间限制为 100 秒。如果文件上传超过该限制，则上传失败。要更改默认值，请按如下方式配置 cdn.s3.retry.interval 和 cdn.s3.max.retry 键：
  • cdn.s3.retry.interval。允许您定义 Citrix Endpoint Management 验证文件上传是否成功完成的间隔（以毫秒为单位）。默认值为 10000。
  • cdn.s3.max.retry。允许您定义在上传失败之前最大验证重试次数。默认值为 10。
这两个键协同工作以限制文件上传时间。默认情况下，时间限制为 100 秒（10000*10 毫秒）。

证书续订（秒）

  • 证书过期前 Citrix Endpoint Management 开始续订证书的秒数。例如，当证书于 12 月 30 日过期且此属性设置为 30 天时。如果设备在 12 月 1 日至 12 月 30 日之间连接，Citrix Endpoint Management 会尝试续订证书。默认为 2592000 秒（30 天）。

连接超时

  • 会话不活动超时（以分钟为单位），在此之后 Citrix Endpoint Management 会关闭与设备的 TCP 连接。会话保持打开状态。适用于 Android 设备。默认为 5 分钟。

默认部署通道

  • 确定 Citrix Endpoint Management 如何将资源部署到设备：用户级别 (DEFAULT_TO_USER) 或设备级别。默认为 DEFAULT_TO_DEVICE。

弃用移动服务提供商

  • 弃用对用于查询 Blackberry 和其他 Exchange ActiveSync 设备的移动服务提供商接口的支持。启用后，移动服务提供商接口将从控制台中隐藏。默认值为 true。

设备标记

  • 如果将 enable.device.tagging 设置为 true，Citrix Endpoint Management 会自动按设备类型标记设备。您可以使用设备标记来部署策略和应用程序或配置交付组。Citrix Endpoint Management 会为以下设备应用标记：
    • BYOD 标记
      • iOS 用户注册
      • Android Enterprise 工作配置文件
    • 公司标签
      • Android Enterprise 完全托管的企业设备
      • 批量注册
        • 苹果商务管理设备
        • 苹果校园管理设备
        • Windows AutoPilot 设备
        • Android Enterprise 批量注册

禁用主机名验证

  • 默认情况下，除 Microsoft PKI 服务器外，出站连接上均启用主机名验证。当主机名验证失败时，服务器日志中会包含以下错误：“无法连接到批量购买服务器：主机名 '192.0.2.0' 与对等方提供的证书主题不匹配”。如果主机名验证导致部署中断，请将此属性更改为 true。默认为 false。

禁用 SSL 服务器验证

  • 如果为 True，则在满足以下所有条件时禁用 SSL 服务器证书验证：
    • 您已在 Citrix Endpoint Management 上启用基于证书的身份验证
    • Microsoft CA 服务器是证书颁发者
    • 内部 CA（其根证书不受 Citrix Endpoint Management 信任）签署了您的证书。
    默认为 True。

启用崩溃报告

  • 如果为 true，Citrix 会收集崩溃报告和诊断信息，以帮助排查适用于 iOS 和 Android 的 Citrix Secure Hub 的问题。如果为 false，则不收集任何数据。默认值为 true。

启用/禁用 Hibernate 统计信息日志记录用于诊断

  • 如果为 True，则启用 Hibernate 统计信息日志记录，以帮助排查应用程序性能问题。Hibernate 是用于 Citrix Endpoint Management 连接到 Microsoft SQL Server 的组件。默认情况下，日志记录处于禁用状态，因为它会影响应用程序性能。仅在短时间内启用日志记录，以避免创建巨大的日志文件。Citrix Endpoint Management 将日志写入 /opt/sas/logs/hibernate_stats.log。默认为 False。

启用 macOS OTAE

  • 如果为 false，则阻止 macOS 设备使用注册链接，这意味着 macOS 用户只能通过注册邀请进行注册。默认为 true。

启用通知触发器

  • 启用或禁用 Citrix Secure Hub 客户端通知。值为 true 时启用通知。默认为 true。

完全拉取 ActiveSync 允许和拒绝的用户

  • Citrix Endpoint Management 拉取 ActiveSync 允许和拒绝用户的完整列表（基线）的间隔（以秒为单位）。默认为 28800 秒。

标识遥测是否已启用

  • 标识遥测是否已启用。遥测也称为客户体验改善计划 (CEIP)。您可以在安装或升级 Citrix Endpoint Management 时选择加入 CEIP。如果 Citrix Endpoint Management 连续 15 次上传失败，它将禁用遥测。默认为 false。

不活动超时（分钟）

  • Citrix 端点管理在非活动用户注销前的分钟数。用户必须已使用 Citrix 端点管理公共 API 访问 Citrix 端点管理控制台或任何第三方应用程序。超时值设置为 0 表示非活动用户保持登录状态。对于访问 API 的第三方应用程序，保持登录通常是必需的。默认值设置为 5。
  • 如果 WebServices timeout type 服务器属性为 INACTIVITY_TIMEOUT：此属性定义了 Citrix 端点管理在非活动管理员执行以下操作后注销前的分钟数：
    • 使用 REST 服务的公共 API 访问 Citrix 端点管理控制台
    • 使用 REST 服务的公共 API 访问任何第三方应用程序。超时值设置为 0 表示非活动用户保持登录状态。

include.device.properties.during.search

  • 在设备搜索中包含所有设备属性。默认值为 Off，这将搜索范围限制为以下设备属性，以实现快速搜索：
    • 序列号
    • IMEI
    • Wi-Fi MAC 地址
    • 蓝牙 MAC 地址
    • 活动同步 ID
    • 用户名
    当此属性设置为 On 时，设备搜索可能需要更长时间。

ios.delayBeforeDeclareUnreachable; macos.delayBeforeDeclareUnreachable

  • 指定离线 iOS 或 macOS 设备被视为不可达的天数。当 iOS 或 macOS 设备达到指定限制时，它们将停止与 Citrix 端点管理进行检查。这两个属性的默认值均为 45 天。

iOS 设备管理注册（如果需要）安装根 CA

  • 对于所有 Citrix Endpoint Management 环境，服务器属性 ios.mdm.enrollment.installRootCaIfRequired 都设置为 False。Citrix Endpoint Management 使用公开信任的证书链，因此无需将根 CA 推送到设备。（此属性仅用于本地环境。）

iOS 设备管理注册最后一步延迟

  • 在设备注册期间，此属性值指定在安装 MDM 配置文件和在设备上启动代理之间等待的时间量。Citrix 建议仅在出现网络延迟或速度问题时编辑此属性。在这种情况下，请勿将该值设置为超过 5000 毫秒（5 秒）。默认值为 1000 毫秒（1 秒）。

iOS 设备管理身份交付模式

  • 指定 Citrix Endpoint Management 是使用 SCEP（出于安全原因推荐）还是 PKCS12 将 MDM 证书分发到设备。在 PKCS12 模式下，密钥对在服务器上生成，不进行协商。默认值为 SCEP。

iOS 设备管理身份密钥大小

  • 定义 MDM 身份、iOS 配置文件服务和 Citrix Endpoint Management iOS 代理身份的私钥大小。默认值为 2048。

iOS 设备管理身份续订天数

  • 指定在证书过期前多少天 Citrix Endpoint Management 开始续订证书。例如：如果证书在 10 天内过期，并且此属性为 10 天：当设备在过期前 9 天连接时，Citrix Endpoint Management 会颁发新证书。默认值为 30 天。

iOS MDM APNS 私钥密码

  • 此属性包含 APNs 密码，Citrix Endpoint Management 需要此密码才能将通知推送到 Apple 服务器。

设备断开连接前的非活动时长

  • 指定设备在 Citrix Endpoint Management 断开连接之前可以处于非活动状态（包括上次身份验证）的时长。默认值为 7 天。

设备在自动从 CEM 中移除前的非活动时长

  • 设备在自动从 Citrix Endpoint Management 中移除之前可以处于非活动状态的时间长度（以天为单位）。最短为 14 天，默认值为 30 天。此属性生效，必须将“允许删除在指定时间段内标记为非活动的设备”服务器属性设置为 true。

local.user.account.lockout.time

  • 指定用户在超出锁定限制后必须等待的分钟数。支持的值为 0–999。默认值为 30 分钟。

local.user.account.lockout.limit

  • 指定每个用户连续无效登录尝试的最大次数。支持的值为 0–999。默认值设置为 6。

mac.dep.admin.passwd.rotate

此服务器属性允许您为通过 Apple Deployment Program 注册的 macOS 设备配置管理员密码轮换间隔。Citrix Endpoint Management 每天检查是否轮换管理员帐户的密码。默认情况下，Citrix Endpoint Management 每 10,080 分钟（7 天）轮换一次密码。按如下方式配置 mac.dep.admin.passwd.rotate 密钥：
  • 值：管理员定义 Citrix Endpoint Management 轮换密码的间隔（以分钟为单位）。键入一个等于或大于 360（6 小时）的值。Citrix Endpoint Management 会忽略小于 360 的值，并改为每 360 分钟（6 小时）轮换一次密码。
  • 显示名称：管理员定义
  • 描述：管理员定义

仅限 MAM 设备最大值

  • 此自定义密钥限制每个用户可以注册的仅限 MAM 设备的数量。按如下方式配置密钥。值为 0 允许无限设备注册。
  • 密钥 = number.of.mam.devices.per.user
  • 值 = 5
  • 显示名称 = 仅限 MAM 设备最大值
  • Description = 限制每个用户可以注册的 MAM 设备数量。

MaxNumberOfWorker

  • 导入大量批量购买许可证时使用的线程数。默认为 3。如果需要进一步优化，可以增加线程数。但是，线程数越多会导致 CPU 使用率越高。

NetScaler Gateway (NetScaler) 单点登录

  • 如果为 False，则在从 NetScaler Gateway 到 Citrix Endpoint Management 的单点登录期间禁用 Citrix Endpoint Management 回调功能。如果 NetScaler Gateway 配置包含回调 URL，Citrix Endpoint Management 将使用回调功能验证 NetScaler Gateway 会话 ID。默认为 False。

连续上传失败次数

  • 显示客户体验改善计划 (CEIP) 上传期间连续失败的次数。当上传失败时，Citrix Endpoint Management 会增加该值。在 15 次上传失败后，Citrix Endpoint Management 会禁用 CEIP（也称为遥测）。有关详细信息，请参阅服务器属性 Identifies if telemetry is enabled or not。当上传成功时，Citrix Endpoint Management 会将该值重置为 0。

每设备用户数

  • 可以在 MDM 中注册同一设备的最大用户数。值 0 表示可以注册同一设备的无限数量的用户。默认为 0。

optional.user.identity.attributes

  • 此服务器属性允许您自定义可选的 Active Directory 用户属性。
    创建自定义密钥，并在“值”字段中编辑用户属性，以定义 Citrix Endpoint Management 可以访问哪些属性来创建用户帐户。有关详细信息，请参阅自定义用户属性。
    • 密钥：Custom Key
    • 密钥：optional.user.identity.attributes
    • 值：通用名称, 名, 姓, 显示名称, 街道地址, 城市, 州/省, 国家/地区, 工作电话, 家庭电话, 手机, 公司, 部门, 描述, 员工ID, 传真号码, 姓名首字母, IP电话, 经理, 家庭邮政地址, 其他手机, 寻呼机, 物理交付办公室名称, 邮政编码, 邮政信箱, 职称, 组织, 首选语言
    • 显示名称：optional.user.identity.attributes
    • 描述：可选的 Active Directory 用户属性

macOS 和 iOS/iPadOS 注册配置文件中的组织名称

  • 您为 apple.mdm.enrollment.profile.organization.name 输入的值对应于提供注册配置文件的组织的名称。当用户将其设备注册到 Citrix Endpoint Management 时，将显示该名称。默认显示的名称是 Citrix Workspace。

拉取允许和拒绝用户的增量更改

  • Citrix Endpoint Management 在运行 PowerShell 命令以获取 ActiveSync 设备的增量时，等待域响应的秒数。默认为 60 秒。

Microsoft 认证服务器的读取超时

  • Citrix Endpoint Management 在执行读取操作时，等待证书服务器响应的秒数。如果证书服务器速度慢且流量大，您可以将此值增加到 60 秒或更长时间。如果证书服务器在 120 秒后仍无响应，则需要维护。默认为 15000 毫秒（15 秒）。

REST Web 服务

  • 启用 REST Web 服务。默认为 true。

按指定大小分块检索设备信息

  • 此值在设备导出期间用于内部多线程处理。如果值较高，则单个线程解析更多设备。如果值较低，则更多线程获取设备。减小此值可能会提高导出和设备列表获取的性能，但可能会减少可用内存。默认为 1000。

shp.console.enable

  • 如果为 False，则阻止访问自助服务门户。在端口 4443 上导航到门户的用户会收到“访问被拒绝”消息。如果为 True，则通过端口 443 提供对自助服务门户的访问。
    默认为 False。

enable.new.shp

  • 如果为 False，则阻止用户从自助服务门户启用其设备。如果为 True，则用户可以从自助服务门户启用其设备。
    BitLocker 恢复密钥功能要求您将此属性设置为 False，并将 shp.console.enable 属性设置为 True。
    默认为 False。

会话日志清理（天）

  • Citrix Endpoint Management 保留会话日志的天数。默认为 7。

ShareFile 配置类型

  • 指定 Citrix Files 存储类型。ENTERPRISE 启用 Citrix Files 企业模式。CONNECTORS 仅提供对您通过 Citrix Endpoint Management 控制台创建的存储区域连接器的访问权限。默认为 NONE，这将显示“配置 > Citrix Files”屏幕的初始视图，您可以在其中选择 Citrix Files Enterprise 和连接器。默认为 NONE。

静态超时（分钟）

  • 如果 WebServices timeout type 服务器属性为 STATIC_TIMEOUT：此属性定义了 Citrix Endpoint Management 在管理员使用以下各项后注销管理员的分钟数：
    • 用于访问 Citrix Endpoint Management 控制台的 REST Services 公共 API。
    • 用于访问任何第三方应用程序的 REST Services 公共 API。
    默认为 60。

触发代理消息抑制

  • 启用或禁用 Citrix Secure Hub 客户端消息传送。值 false 启用消息传送。默认为 true。

触发代理声音抑制

  • 启用或禁用 Citrix Secure Hub 客户端声音。值 false 启用声音。默认为 true。

适用于 Android 设备的未经身份验证的应用下载

  • 如果为 True，则可以将自托管应用程序下载到运行 Android Enterprise 的 Android 设备。如果启用了 Android Enterprise 选项以在 Google Play 商店中静态提供下载 URL，则 Citrix Endpoint Management 需要此属性。在这种情况下，下载 URL 不能包含一次性票证（由 XAM One-Time Ticket server 属性定义），该票证包含身份验证令牌。默认为 False。

适用于 Windows 设备的未经身份验证的应用下载

  • 仅用于不验证一次性票证的旧版 Citrix Secure Hub。如果为 False，则可以从 Citrix Endpoint Management 下载未经身份验证的应用程序到 Windows 设备。默认为 False。

使用 ActiveSync ID 执行 ActiveSync 设备擦除

  • 如果为 true，则 Citrix Endpoint Management 的 Exchange ActiveSync 连接器将 ActiveSync 标识符用作 asWipeDevice 方法的参数。默认为 false。

仅来自 Exchange 的用户

  • 如果为 true，则禁用 ActiveSync Exchange 用户的用户身份验证。默认为 false。

批量采购基线间隔

  • Citrix Endpoint Management 从 Apple 重新导入批量采购许可证的最小间隔。刷新许可证信息可确保 Citrix Endpoint Management 反映所有更改，例如手动从批量采购中删除导入的应用程序时。默认情况下，Citrix Endpoint Management 至少每 1440 分钟刷新一次批量采购许可证基线。
    • 如果您安装了大量批量采购许可证（例如，超过 50,000 个）：Citrix 建议您增加基线间隔，以减少导入许可证的频率和开销。
    • 如果您预计 Apple 会频繁更改批量采购许可证：Citrix 建议您降低该值，以使 Citrix Endpoint Management 及时更新这些更改。
    • 两个基线之间的最小间隔为 60 分钟。此外，Citrix Endpoint Management 每 60 分钟执行一次增量导入，以捕获自上次导入以来的更改。因此，如果批量采购基线间隔为 60 分钟，则基线之间的间隔可能会延迟长达 119 分钟。

WebServices 超时类型

  • 指定如何使从公共 API 检索到的身份验证令牌过期。
    • 如果是 STATIC_TIMEOUT：Citrix Endpoint Management 根据服务器属性 Static Timeout in Minutes 的值，将令牌视为已过期。
    • 如果是 INACTIVITY_TIMEOUT：Citrix Endpoint Management 根据服务器属性 Inactivity Timeout in Minutes 的值，将令牌视为已过期。默认为 STATIC_TIMEOUT。

Windows 平板电脑 MDM 证书延长有效期 (5 年)

  • MDM 为 Windows 平板电脑颁发的设备证书的有效期。设备在设备管理期间使用设备证书向 MDM 服务器进行身份验证。如果为 true，则有效期为五年。如果为 false，则有效期为两年。默认为 true。

Windows WNS 通道 - 续订前天数

  • ChannelURI 的续订频率。默认为 10 天。

Windows WNS 心跳间隔

  • Citrix Endpoint Management 在每三分钟连接设备五次后，再次连接设备之前等待的时间。默认为 6 小时。

XAM 一次性票证

  • 一次性身份验证令牌 (OTT) 下载应用程序的有效毫秒数。此属性与属性 Unauthenticated App download for Android 和 Unauthenticated App download for Windows 协同工作。这些属性指定是否允许未经身份验证的应用程序下载。默认为 3600000。

Citrix Endpoint Management MDM 自助服务门户控制台最大非活动间隔（分钟）

  • 此属性名称反映了较旧的 Citrix Endpoint Management 版本。该属性控制 Citrix Endpoint Management 控制台的最大非活动间隔。该间隔是指 Citrix Endpoint Management 将非活动用户从 Citrix Endpoint Management 控制台注销的分钟数。超时设置为 0 意味着非活动用户将保持登录状态。默认值为 30。

从 ABM MDM 服务器取消分配时，从 CEM 中删除 ABM 设备

  • 如果 remove.unassigned.abm.devices 为 true，CEM 会移除不再分配给此服务器的设备。默认为 false。