使用命令行选项 | iFX 6.5

可以从命令行运行“备份和恢复”应用程序。如果需要通过脚本或外部程序实现自动备份和恢复，这个功能就尤其有用。

BackupRestore.exe命令行的语法如下：

备份语法

BackupRestore.exe

[/FactoryDefault]

/B=<file name with full path>

[/F]

[/P=<project path> or /P=UseINI]

[/BackupSec]

[/S or /Y]

[/I=<ini file name>]

恢复语法

BackupRestore.exe

[/FactoryDefault]

/R=<file name with full path>

[/A]

[/A=<project path> [/N=<node name>] [/X]]

[/P=<project path> or /P=UseINI]]

[/C]

[[/RestoreSec] or [/DelSec]]

[/S or /Y]

[/I=<ini file name>]

语法提示

方括号( [ ] )表示参数是可选的。方括号本身不是命令的一部分，如果使用方括号内的选项，只要键入方括号内部的文本就可以了，不要把方括号本身也输入进去。
斜体字部分代表用户运行命令时必须提供的信息。斜体字信息不要按原样输入。要根据个人的需要填入特定的信息。

列出了BackupRestore.exe可用的命令行选项：

可用的命令行选项
命令行选项	描述
/F	指定某个工程路径的所有文件的“全备份”，包括安全文件在内。
/FactoryDefault	执行出厂默认备份或恢复。
/P	指定用于“备份”的源工程路径或用于“恢复”的目标工程路径。
/P=UseINI	指定用于“备份”的源工程路径或用于“恢复”的目标工程路径。允许指定所有在INI文件中设置的子工程路径的全路经。
/A	在恢复中使用当前的SCU文件名、节点名和工程路径。
/A=<project path>	在恢复中使用当前的SCU文件名、节点名和工程路径。
/N=<node name>	指定想要恢复的节点的节点名称。与/A选项一起使用。
/X	指定不想重新命名带有恢复的节点名称的当前节点名称。与/A选项一起使用。
/C	恢复一个定义和完全备份文件之前，删除选定工程路径下的所有存在的文件。
/BackupSec	包括备份中的安全文件。
/RestoreSec	恢复过程中，用归档的文件中的安全设置替换当前安全设置。
/DelSec	删除所有存在的安全文件，并禁用恢复安全。
/S	在后台模式运行备份和恢复工程，隐藏进度条或用户提示。
/Y	在后台模式运行备份和恢复工程时自动处理用户提示并显示进度条。
/I	指定一个特定的 .INI 文件和路径。默认时，备份和恢复读取本地路径下的 BackupRestore.ini文件。默认时，备份和恢复读取本地路径下的 BackupRestore.ini文件。通过使用/l命令，可以指定另一个.INI文件名称。然而，格式必须与BackupRestore.ini文件相同。更多信息，请参考BackupRestore.ini示例部分。
/?	打开命令行选项帮助。

注意：如果运行备份时未定义/P选项，从当前SCU设置获取源路径。如果运行恢复时未定义/P或/A选项，目标是当前SCU设置。

示例

该命令执行一个自定义备份，包含安全文件，不显示备份和恢复向导。

BackupRestore.exe /B="C:\Program Files (x86)\GE\iFIX\ProjectBackup\FIX.fbk" /S /BackupSec

该命令执行一个工程恢复到当前工程路径，不显示备份和恢复向导：

BackupRestore.exe /R="C:\Program Files (x86)\GE\iFIX\ProjectBackup\FIX.fbk" /S /RestoreSec

该命令执行一个工程恢复到归档在SCU中的工程路径，并且为恢复过程显示进度条。

BackupRestore.exe /R="C:\Program Files (x86)\GE\iFIX\ProjectBackup\FIX.fbk" /A /Y

注意：包含/A命令时，可能需要查看SCU，看看基路机构是否已修改。

该命令执行一个工厂默认备份，不显示备份和恢复向导：

BackupRestore.exe /FactoryDefault /B="C:\Program Files (x86)\GE\iFIX\ProjectBackup\FIX.ifd" /S

该命令执行一个工厂默认恢复，不显示备份和恢复向导：

BackupRestore.exe /FactoryDefault /R="C:\Program Files (x86)\GE\iFIX\ProjectBackup\FIX.ifd" /S

返回码

备份和恢复应用程序运行后返回退出码。

退出码	描述
0	备份或恢复操作完成无误。运行备份和恢复用户界面时，而不使用命令行，退出码也将为0。
1	备份或恢复操作失败，有一个错误。这通常表示在操作过程中产生该错误。例如：备份文件不能被打开，备份文件被破坏，或安全设置不能被调整。
2	备份或恢复操作不能启动，任何原因。例如：检测到一个无效的命令，或未找到一个指定的文件。此外，当您运行 BackupRestore.exe /? help 命令时，退出代码为 2。

BackupRestore.exe程序返回1或2时，操作失败。如果打开操作日志文件之前，检测到一个错误，这些错误被记录在BackupRestoreDefaultLog.txt文件中。默认地，该文件位于iFIX基路径下。如果安装iFIX到默认位置，那么该基路径是 C:\Program Files (x86)\GE\iFIX 文件夹。

如果返回1或2，请首先查看BackupRestoreDefaultLog.txt中错误的详细信息。如果那里没有信息，然后查看实际操作日志(BackupLog.txt or RestoreLog.txt)。

需要明白的是，BackupRestoreDefaultLog.txt日志也包含BackupRestore.exe程序启动时的完整命令行参数信息。