通过

DMCommonInstaller.ini 和 ClientSettings.ini 的移动设备客户端配置值

  • 项目

应用到: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

Microsoft System Center Configuration Manager 2007 在移动设备客户端安装、升级和卸载过程中使用 DMCommonInstaller.ini 或 ClientSettings.ini。.ini 文件中的值指定是否安装、升级或卸载客户端，并配置如何执行过程。在安装和升级过程中，.ini 文件的值将用于配置移动设备客户端。

配置文件值

.ini 文件中的值类别如下：

  • 安装值

  • Microsoft System Center Configuration Manager 2007 环境值

  • 通信值

  • 用户界面配置值

  • 证书值

安装值

DMCommonInstaller.ini 文件和 ClientSettings.ini 文件定义客户端安装的值。

安装程序库值

这些值定义移动设备客户端安装期间使用的文件，以及要安装的移动设备的基本参数。此外，它们还指定详细日志记录将被关闭。对于 DMCommonInstaller.ini，这些文件均被标记为“请勿更改”，因为已为特定平台配置了这些文件。对于 ClientSettings.ini，指定的值可用于目标移动设备平台。

Installer - 特定于平台的设备管理安装程序的名称。文件名格式为 DMInstaller_[平台].exe。有关移动设备客户端安装程序的详细信息，请参阅如何安装或升级移动设备管理客户端。

ClientSetup - 特定于平台的移动设备客户端安装程序的名称。文件名格式为 DMClientSetup_[平台].exe。

Client - 移动设备客户端安装所需的特定于平台的客户端 Cab 文件的名称。文件名格式为 DeviceClient_[平台].exe。

ClientVersion - 要安装的移动设备客户端的版本。BaseOSMinVersion - 操作系统支持客户端所需的平台的最低版本号。

BaseOSMaxVersion - 操作系统支持客户端所需的平台的最高版本号。

Devicetype - 移动设备客户端支持的移动设备类型。

ProcessorType - 移动设备客户端支持的处理器类型。

EnableVerboseLogging - 在移动设备上启用详细日志记录。默认情况下，该值为“False”。

备注

Windows Mobile 6 设备使用 Windows Mobile 5 移动设备客户端安装文件。有关安装文件的详细信息，请参阅移动设备客户端的安装文件。

安装程序配置

这些值指定安装过程的选项，如是否安装、升级或卸载客户端，以及在安装过程中是否应用其他文件或命令。

ClientInstallAction - 定义安装程序要执行的操作。默认情况下，ClientInstallAction 设置为“Install”。此设置支持三个值：

  • “None”- 不更改移动设备客户端状态。

  • “Install”- 将使用安装包分发的移动设备客户端安装到移动设备上。

  • “Uninstall”- 从移动设备删除移动设备客户端。此选项卸载移动设备客户端。

如果将根据移动设备客户端的状态设置移动设备管理设置：

设备状态

客户端部署操作

无客户端

安装部署的客户端

客户端早于部署的客户端

升级至部署的客户端

与分步客户端相同的客户端

重新配置客户端设置

客户端比分步客户端更新

无操作

InstallType - 定义要执行的安装类型。默认情况下，InstallType 设置为“Clean”。此设置支持两个值：

  • “Clean”表示删除程序数据库

  • “Preserve”表示保留已安装程序的记录

重要

对于必需的“无线”升级设置“InstallType=clean”将导致移动设备重复下载并升级移动设备客户端策略。

Pre-InstallCommandLine - 定义在安装移动设备客户端或在移动设备上执行其他操作之前要运行的命令行。默认情况下注释禁止此选项。

Post-InstallCommandLine - 定义在安装移动设备客户端或在移动设备上执行其他操作之后要运行的命令行。默认情况下注释禁止此选项。

AdditionalFileX - 定义在运行安装程序时要复制到移动设备的 \temp\dminstall 文件夹的其他文件。通过在“AdditionalFile”名称后附加编号来确保每个文件都有唯一项目。默认情况下注释禁止此选项。

Configuration Manager 环境值

环境值定义 Configuration Manager 2007 移动设备客户端的环境。

站点服务器定义

下列值定义移动设备与之进行信息通信并向其查询策略的服务器。

DMServerName - 移动设备要与其连接的设备管理点的服务器名称。必须定义此值，客户端才能正常操作。

备注

如果更改设备管理点时没有更新服务器名称，移动设备客户端将失去与 Configuration Manager 2007 服务器的通信。有关如何更新移动设备客户端的信息，请参阅如何安装或升级移动设备管理客户端。

ServerPort - 将移动设备客户端用于进行通信的端口从端口 80 (HTTP) 或 443 (HTTPS) 更改为指定的端口号。如果 Configuration Manager 2007 环境使用自定义端口配置，请更改此值并取消注释。默认情况下，此值没有注释。

SiteCode- 移动设备客户端要从其接收策略的站点的站点代码（三位字母数字字符）。如果为客户端指定的 DMServerName 在主站点中，请使用向其中安装客户端的站点的站点代码。如果为客户端指定的 DMServerName 在辅助站点中，请使用辅助站点的父站点的站点代码。在纯安全模式下，必须更改此值，移动设备客户端才能正常操作。有关站点代码的详细信息，请参阅了解 Configuration Manager 站点。

FSPServerName - 移动设备向其发送 FSP 消息的回退状态点的服务器名称。FSPServerName 可定义为 NetBIOS 名称、FQDN 或 URL。回退状态点服务器应当定义为一个 URL 并在外部 DNS 中发布，以便基于 Internet 的设备连接。基于 Internet 的移动设备将只使用 HTTP 联系回退状态点服务器。有关回退状态点的详细信息，请参阅关于 Configuration Manager 中的回退状态点。

FSPPort - 移动设备客户端用于与回退状态点服务器通信的主 HTTP 端口。FSPPort 默认为 80。

FSPAlternatePort - 移动设备客户端用于与回退状态点服务器通信的备用 HTTP 端口。FSPPort 默认为 80。

通信值

SecurityMode - 定义移动设备客户端身份验证的安全模式。SecurityMode 的默认值为“None”。SecurityMode 接受三个值：

  • “None”- 不需要服务器或客户端身份验证。

  • “SSLServerAuth”- 需要安全 HTTP (HTTPS) 服务器身份验证。设备上必须安装服务器证书，有关详细信息，请参阅文档。

  • “NativeMode”- 在设备客户端和 DMP/DP 之间需要安全 HTTP (HTTPS) 相互身份验证。需要客户端身份验证证书以便为客户端注册 Configuration Manager 2007 数据库并签署客户端数据。

CreateConnection - 定义何时为 Configuration Manager 2007 移动设备客户端通信创建连接。CreateConnection 的默认值为“USER”。CreateConnection 接受三个值：

  • “ALL”- 允许移动设备客户端为任何操作创建连接。

  • “USER”- 允许移动设备客户端仅为用户调用的操作调用连接。

  • “NEVER”- 阻止移动设备客户端为任何操作调用连接。移动设备客户端仅在现有连接上通信。

InternetConnected - 表明设备客户端是否连接到来自 Internet 的设备管理点。默认值为“False”。InternetConnected 接受两个值：

  • “True”- 移动设备客户端正连接到来自 Internet 的设备管理点。

  • “False”- 移动设备客户端未连接到来自 Internet 的设备管理点。

用户界面配置

EnforceConfig - 定义为某些选项禁用移动设备配置用户界面，以使用户无法更改 Configuration Manager 2007 移动设备配置设置。默认值为“ServerName”。EnforceConfig 接受三个值：

  • “None”- 允许用户更改服务器名称、安全模式和自动连接选项。

备注

在运行移动设备客户端安装程序（例如，移动设备插接）时，用户修改的服务器名称和安全模式设置将被覆盖。

  • “ServerName”- 防止用户编辑服务器名称和安全模式选项。

  • “All”- 防止用户编辑服务器名称、安全模式和自动连接选项。

证书值

DMCommonInstaller.ini 文件和 ClientSettings.ini 文件定义证书部署和注册值。这些值必须根据您的特定环境来编辑。以下是将证书部署到设备的值的类别：

  • 证书注册程序

  • 导入证书

  • 续订站点服务器签名证书

证书注册程序值

DMCommonInstaller.ini 文件或 ClientSettings.ini 文件中的下列值用于在客户端安装或升级过程中定义证书注册。如果要注册证书，则根据站点环境定义下列值：

CertEnrollAction - 定义在移动设备客户端安装过程中是否注册证书。CertEnrollAction 的默认值为“Enroll”。CertEnrollAction 接受三个值：

  • “None”- 不注册证书。

  • “Enroll”- 如果现有证书无法用于设备注册，则注册客户端身份验证证书并将服务器证书添加到移动设备的根证书存储。系统将提示用户输入其凭据以注册证书。

  • “ForceEnroll”- 注册客户端身份验证证书并将服务器证书添加到移动设备的根证书存储，不考虑现有已注册证书的当前状态。系统将提示用户输入其凭据以注册证书 CertEnrollAction=Enroll。

CertEnrollServer - Internet Information Services (IIS) Web 服务器前端到证书颁发机构 (CA) 的名称。

CertEnrollServerPort - Internet Information Services (IIS) Web 服务器前端到证书颁发机构 (CA) 的端口号。

备注

Configuration Manager 2007移动设备证书注册程序不支持 HTTPS。

CertSubjectName - 指定用户存储中要使用哪个证书来注册移动设备的提示。移动设备管理客户端将尝试使用者名称包含有效 CertSubjectName 条件的所有证书。如果此值为“None”，则将尝试用户存储中所有有效的客户端身份验证证书。默认情况下，此值为“None”。使用者名称格式如下：

CertSubjectName = 此站点服务器的站点代码为 [站点代码]

其中，[站点代码] 是站点服务器的站点代码。此字符串不区分大小写。

CertRequestPage - Web 服务器上接收证书请求的网页。

CertDownloadPage - Web 服务器上用于下载证书的网页。

CertChainDownloadPage - Web 服务器上用于下载证书链的网页。

导入证书值：ImportCerts

ImportCerts - 定义要导入移动设备的证书存储中的证书文件 (*.cer)。此选项可用于部署安全模式所需的证书。证书文件 (*.cer) 必须包含在移动设备客户端部署文件夹中。要导入的证书必须采用可分辨编码规则 (DER) 编码的二进制 X.509 格式。不支持 Base-64 编码的 X.509 证书。默认值为“False”。ImportCerts 接受两个值：

  • “True”- 导入证书。

  • “False”- 不导入证书。

续订站点服务器签名证书

EnableSSSCRenewal - 定义在站点服务器签名证书到期时是否应续订。

  • “True”- 启用站点服务器签名证书续订

  • “False”- 不启用站点服务器签名证书续订

另请参阅

概念

如何为移动设备管理编辑 ClientSettings.ini 文件
如何为移动设备管理编辑 DMCommonInstaller.ini 文件
如何安装或升级移动设备管理客户端

有关其他信息，请参阅 Configuration Manager 2007 Information and Support。
要与文档团队联系，请将电子邮件发送至 SMSdocs@microsoft.com。