Product Documentation

配置命令语法

Sep 14, 2015

在安装了 XenApp 服务器角色的服务器上,从 C:\Program Files (x86)\Citrix\XenApp\ServerConfig 中,在命令提示符处键入以下内容:

XenAppConfigConsole.exe [options]

下表介绍了配置命令选项,这些选项按类别分组。
注意:还可以使用此命令删除 XenApp 服务器角色;请参阅删除角色和组件
与配置过程和命令相关的选项
/help
显示命令帮助。
/NotStrict
允许可执行文件继续处理,即使选项并不适用于当前上下文。
/Confirm
修改服务器之前显示确认消息。在测试命令选项的使用是否正确时,此选项可能有用。
/Pause
处理完成之后暂停可执行文件。当从批处理文件启动命令时,此选项可以阻止命令提示符关闭。
/LogFilename:file
将可执行文件的进度记录到日志文件中。在日志中,符号 >> 表示函数调用;符号 << 表示函数返回。默认为:C:\Windows\Temp
常规场信息选项
/ExecutionMode:Create | Join | Leave | ImagePrep
(必需项)指定要执行的任务。
  • 创建。在第一台服务器上安装 XenApp 后,该服务器即成为配置过程中创建新场的服务器。
  • Join。在其他服务器上安装 XenApp 之后,将每台服务器添加到(加入)现有场。
  • ImagePrep。(仅当之前已配置 XenApp 服务器角色时才有效)为映像操作准备服务器。
  • Leave。(仅当之前已配置 XenApp 服务器角色时才有效)从场中删除服务器。
/FarmName:name
(必需项,仅与 /ExecutionMode:Create 一起使用才有效)指定场名称,最多包含 32 个字符(可以包含空格)。如果您使用 Oracle 作为配置日志记录数据库,请勿在场名称中使用连字符。
/CitrixAdministratorAccount:domain\user
(必需项,仅与 /ExecutionMode:Create 一起使用才有效)为即将成为第一位 Citrix 管理员的用户指定域和用户名。管理员拥有场的完全权限,而且可以创建其他管理员帐户。
/ZoneName:name
指定区域名称。默认值:默认区域
/AddLocalAdmin:True | False
(仅与 /ExecutionMode:Create 一起使用时才有效)启用或禁用为本地管理员组中的所有用户帐户创建 Citrix 管理员帐户。默认值:False
/ImaWorkerMode: True | False
(仅与 /ExecutionMode:Join 一起使用时才有效)启用或禁用将服务器用作数据收集器或 XML Broker 的功能。有关详细信息,请参阅 XenApp 服务器模式。默认值:False(服务器可以用作数据收集器或 XML Broker)
用于场数据存储的数据库选项

如果使用 Microsoft SQL Server Express 数据库,则可以在创建 XenApp 场时使用 /SimpleDB 选项简化配置。加入使用该数据库的场时,请使用 /ServerName 选项指定创建场时所在的 XenApp 服务器名称。

/SqlExpressRootDir:ir
指定 SQL Server Express 源安装目录的位置。默认位置为:C:\Program Files (x86)\Citrix\XenApp\ServerConfig\SqlExpress_2008。
/SimpleDB
指示场使用 SQL Server Express 数据库来实现数据存储。
/ServerName:name
(仅与 /ExecutionMode:Join 一起使用时才有效,使用 /SimpleDB 时的必需项)指定创建了 XenApp 场(即安装了 SQL Server Express 数据库)的服务器的名称。
/DsnFile:file
指定用于连接到数据存储的 DSN 文件路径。
/AuthenticationType:Windows | Sql
(仅当使用 SQL Server 或 Oracle 数据库进行场数据存储时才有效)指定身份验证类型。默认值:Windows
/OdbcUserName:name
(创建或加入场时的必需项)以 \ 或 \ 形式指定数据库用户名。SQL Server Express 需要现有 Windows 帐户,但该帐户不必是服务器管理员或系统管理员。XenApp 配置将两个数据库管理员添加到 SQL Server Express: (local)\administrators 并为本地用户或域用户添加提供的凭据。
可使用 /OdbcPassword 选项指定数据库密码。
/OdbcPassword:密码
(创建或加入场时的必需项)指定数据库用户密码。
使用 /OdbcUserName 选项指定数据库用户名。
许可证服务器选项

有关详细信息,请参阅许可使用本产品

/LicenseServerName:name
指定现有许可证服务器的名称。
/LicenseServerPort:端口
指定许可证服务器端口。默认值:27000
/LicenseModel:model
指定许可模式。有效值为:
  • XA。如果计划只使用 XenApp 许可证,请指定此模式。
  • XDC。如果计划使用 XenDesktop 并发用户许可证,请指定此模式。
  • XDUD。如果计划使用 XenDesktop 用户或设备许可证,请指定此模式。
默认值:XA
会话重影选项
重要:Citrix 建议使用默认值(即不要在此命令中指定值)。XenApp 配置期间指定的重影设置将覆盖用于用户对用户重影操作的系统策略或域策略。重影功能是永久的,仅当您希望永久阻止系统策略或域策略影响该设置时才应该对其进行更改。如果在配置期间禁用或更改了重影功能,以后将无法对其重新进行配置。
/ProhibitShadowing:True | False
禁用或启用会话重影。默认值:False(启用重影)
/ProhibitRemoteControl:True | False
(仅当启用了重影时才有效)禁止或允许远程控制重影。如果此选项为 True,则授权用户可以查看会话,但无法使用键盘和鼠标输入。默认值:False
/ForceShadowPopup:True | False
(仅当启用重影时才有效)启用或禁用发送重影接受弹出菜单。如果此选项为 True,则授权用户必须在尝试重影会话时发送接受提示。默认值:False
/ForceShadowLogging:True | False
(仅当启用重影时才有效)启用或禁用记录所有重影连接。如果此选项为 True,则会将所有重影尝试、成功以及失败记录到 Windows 事件日志中。默认值:False
Citrix XML Service 端口选项

有关 XML IIS Service Integration 组件的信息,请参阅 Citrix XML 和 IIS Integration

/CustomXmlServicePort:端口
指定 Citrix XML Service 要使用的端口号。默认值:80
/SkipXmlSetting:True | False
如果此选项为 True,则不会配置 Citrix XML Service 与 IIS 端口号(即不使用默认端口 80)。默认值:False
远程桌面用户组选项

只有远程桌面用户组的成员才能连接到已发布应用程序。只有在将用户添加到此组之后,管理员才能远程连接到服务器。指定下列一个或多个选项。

/AddAnonymousUsersToRemoteDesktopUserGroup:True | False
允许或禁止将匿名用户添加到远程桌面用户组中。默认值:True
/AddAuthenticatedUsersToRemoteDesktopUserGroup:True | False
允许或禁止将 Windows 用户组中的当前(和以后)域帐户添加到远程桌面用户组中。默认值:False
/AddUsersGroupToRemoteDesktopUserGroup:True | False
允许或禁止将用户组中的所有当前用户添加到远程桌面用户组中。如果随后添加用户,则必须手动将其添加到远程桌面用户组中。默认值:True
映像准备和置备选项

有关详细信息,请参阅准备进行 XenApp 映像和置备

/RemoveCurrentServer:True | False
(仅当与 /ExecutionMode:ImagePrep 一起使用时才有效)允许或禁止从 XenApp 场中删除当前的服务器实例。默认值:True
/PrepMsmq:True | False
(仅当与 /ExecutionMode:ImagePrep 一起使用时才有效)允许或禁止在重新密封期间重置 MSMQ ID。默认值:True
/ClearLocalDatabaseInformation:True | False
(仅当与 /ExecutionMode:ImagePrep 一起使用时才有效)允许或禁止从 DSN 文件中删除服务器、数据库和故障转移伙伴条目以及将等效的 LGPO 设置设定为 NotConfigured。默认值:True
重要:如果允许删除数据库信息,则 XenApp 假定 Active Directory 策略将提供数据库设置。如果未应用策略,服务器将不会重新启动。
功能和组件选项
/SmartAuditorServerName:name
(如果在 XenApp 服务器上安装了 SmartAuditor 代理,则此选项为必需项)指定 SmartAuditor 服务器名称。
/SsoPluginUncPath:path
Single Sign-On 中央存储的 UNC 路径。默认路径:使用 Active Directory
/OnlinePluginServerUrl:name_url
Citrix Receiver 使用的 Web Interface 服务器名称或 URL。
/PcmFarmName:farm
电源和容量管理场名称。
/PcmWorkloadName:name
电源和容量管理工作负载名称。
/EdgeSightCompanyName:name
EdgeSight 公司名称。
/EdgeSightServerName:name
EdgeSight 服务器名称。
/EdgeSightServerPort:端口
EdgeSight 服务器端口。默认值:80
其他选项
/CreateAnonymousUserAccounts:True | False
创建匿名 Citrix 帐户 Anon000-Anon014。默认值:True
/RemoveAnonymousCitrixAccounts:True | False
删除匿名 Citrix 帐户 Anon000-Anon014。默认值:False

示例

从常规 XenApp 服务器配置工具位置 (C:\Program Files (x86)\Citrix\XenApp\ServerConfig\XenAppCOnfigConsole.exe) 发出的以下命令,可以将服务器加入到场中,从而指定数据库凭据和 DSN 文件位置、许可证服务器和模式信息、日志文件位置以及远程桌面用户组配置设置。
“C:\Program Files (x86)\Citrix\XenApp\ServerConfig\ -XenAppConfigConsole.exe" /ExecutionMode:Join /OdbcUserName:administrator /OdbcPassword:somepasswd /LicenseServerName:somelicenseserver /LicenseServerPort:27000 /LicenseModel:XA /ZoneName:some_zone_name /DsnFile:"c:\somepath\to\example.dsn"  /Log:c:\SomewhereConfigLog.txt /CustomXmlServicePort:8080 /AddAnonymousUsersToRemoteDesktopUserGroup:True /AddUsersGroupToRemoteDesktopUserGroup:True /AddAuthenticatedUserstoRemoteDesktopUserGroup:True