参考指南 › AutoShell › AutoShell 核心参考 › 常规 AutoShell 命令 › dir、ls 命令－获取文件和目录信息 (Funclet)

dir、ls 命令－获取文件和目录信息 (Funclet)

这些命令 (funclet) 列出有关本地或远程系统上指定目录中内容的信息。 可以使用 set alternate to 命令将输出写入文件中。

这些命令具有以下语法：

{dir|ls} mask [-silent] [-retval] [-l] [-user username] [-pass password] [-key key phrase] [-port portnumber]

mask

定义带有搜索掩码的字符串，掩码可以选择包含绝对或相对目录规格。 Windows 上的分隔符可以是反斜杠 (\) 或正斜杠 (/)。 对于 UNIX 类系统，分隔符必须是正斜杠。 为实现跨平台脚本兼容性，仅在路径规格中使用正斜杠。

搜索掩码使用与 DOS 通配符匹配兼容的简化正则表达式语法：

• * 匹配任何字符序列，包括零个字符。
• ? 精确匹配一个字符。
• [abc] 精确匹配 a、b 或 c 中的一个字符。
• [a-f] 匹配从 a 至 f 的任何字符。
• [^a-f] 匹配除 a 至 f 以外的任何字符。
• [-_] 匹配 - 或 _；[^-_] 匹配除 - 和 _ 以外的字符。 短划线“-”紧跟着左括号或 ^ 出现时，不是特殊字符。
• [a^] 匹配 a 或 ^。 （脱字号“^”没有紧跟着左括号出现时，不是特殊字符。
• \*、\?、\[, \]、\\ 匹配单个字符 *、?、[, ]、\。

其他所有字符都不是特殊字符且与自己匹配。

默认值：""

-silent

（可选）禁止输出至活动的输出数据流。

-retval

（可选）创建表示返回值的数组。 数组包含文件信息。 每个元素均包含表示文件名的字符串。 如果指定了参数 -l，则每个元素均由包含以下各项的数组构成：

• item[0]－表示文件名的字符串
• item[1]－表示文件大小的数字
• item[2]－表示上次修改时间的日期
• item[3]－表示目录标志的布尔值
• item[4]－表示完全限定文件名（包括路径）的字符串

-l

（可选）为输出使用长列表格式。

-user username

（可选）指定用于登录到远程节点的用户名。 用户名是密码身份验证或公钥身份验证所必需的。 如果没有指定用户名，则使用在 AutoShell 登录过程中输入的用户名。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。

默认值：$$User

-pass password

（可选）指定用于登录到远程节点的密码。 如果没有指定密码，则使用在 AutoShell 登录过程中输入的密码。 要在发出该命令之后输入隐藏的密码，请指定使用可选提示作为参数的 PW_GET()。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。

默认值：$$Pass

-key key

（可选）指定包含 RSA 私钥的文件的绝对路径或相对路径，用于登录到远程节点。 如果指定了私钥和密码，AutoShell 将首先尝试公钥登录，如果失败，则尝试密码登录。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。 仅在使用公钥身份验证联机创建 SSH 会话时需要此参数。

默认：""

短语

指定私钥的密码。 如果密钥没有加密，则不需要该密码。 要在发出该命令之后输入隐藏的密码，请指定使用可选提示作为参数的 PW_GET()。 未加引号的参数令牌会自动字符串化。 通过用括号括起表达式代码来阻止自动为表达式加引号。

默认：""

-port portnumber

（可选）连接到目标系统的端口。

默认值：SSH 标准端口 22。

示例

获取当前目录的文件名：

dir

获取目录 c:\test 的文件名：

dir c:/test

获取目录 c:\test 和 c:\test\more 的文件名作为文件 test.list 的内容：

set alternate to test.list
dir c:\test
dir c:\test\more
set alternate to

列出远程服务器 ascli1 上 c:\temp 的目录内容：

dir ascli1::c:/temp

获取目录 c:/test/more 的文件名作为数组以进行进一步处理并停止输出到 stdout：

set result disp off
aRet = dir c:/test/more -silent -retval

获取目录 c:/test/more 中文件的扩展信息作为数组以进行进一步处理：

aRet = dir c:/test/more -silent -retval -l

另请参阅：

cd、chdir 命令－更改目录（cmdlet、funclet）

pwd 命令-输出工作目录的名称 (Cmdlet)

set alternate to 命令－设置备用输出文件 (Cmdlet)