run-winRemote 命令在一个或多个远程 Windows 系统上执行命令。 该命令具有两种风格:
单目标版本将输入和输出重定向到调用 AutoShell。
run-winRemote 的多目标版本采用异步方式。 请参阅示例代码以了解如何检索结果。
命令的语法如下:
(1) run-winRemote -host hostname [-cmd cmd] [-user username] [-pass password] [-workDir workDir]
(2) run-winRemote [-cmd cmd] [-user username] [-pass password] [-workDir workDir] on remoteTargets
run-winRemote 的单目标版本返回已执行命令的结果代码。
多目标版本返回一个 WinRemote 对象数组。 该数组的每个元素与 remoteTargets 列表列出的远程 Windows 节点的位置一致。 WinRemote 对象可以验证多个结果,例如,执行是否完成、是否有错误发生或执行是否成功完成。 如果已使用 WinRemote 对象指定远程节点,则数组会包含对原始 RemoteTarget 对象的引用。 如果已使用字符串指定目标系统,则将在内部创建新的 RemoteTarget 对象并将其分配给数组。
(可选)指定远程 Windows 主机的名称。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。
(可选)指定要在远程 Windows 系统上执行的命令。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。 仅在使用公钥身份验证联机创建 SSH 会话时需要此参数。
默认值:cmd
(可选)指定用于登录到远程 Windows 系统的用户名。 用户必须具有连接到 $ADMIN 共享的权限。 如果没有指定用户名,则使用在 AutoShell 登录过程中输入的用户名。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。
默认值:$$User
(可选)指定用于登录到远程节点的密码。 如果没有指定密码,则使用在 AutoShell 登录过程中输入的密码。 要在发出该命令之后输入隐藏的密码,请指定使用可选提示作为参数的 PW_GET()。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。
默认值:$$Pass
指定实际工作目录。
默认:""
指定要运行指定脚本的远程系统的逗号分隔列表。 可以通过两种方式标识目标节点:按主机名/地址或按 WinRemote 对象。 按名称或地址指定目标系统,同时使用 WinRemote 对象可以更灵活地控制执行进程,例如,不同的凭据用于不同的主机。 WinRemote 对象和包含主机名/地址的字符串可以在远程目标列表中同时使用。 目标列表的元素不是自动字符串化的,因此在主机名中使用文本字符串时必须将其置于引号内。
示例
在 host1 上运行 cmd.exe(命令 shell):
run-winRemote -host host1 -cmd cmd.exe
在 host1 和 host2 上运行 mybatch.bat 并验证 host2 的结果
x = run-winRemote -cmd mybatch.bat -localpath c:\installations\myinstall.exe on "host1", "host2"; ? x[1].hasCompleted(); ? x[1].result(); ? x[1].output();
版权所有 © 2013 CA。
保留所有权利。
|
|