Ni系统配置20.5 API参考

设置系统镜像 (VI)

  • 更新时间2023-02-21
  • 阅读时长7分钟
安装: NI系统配置

应用系统镜像文件或文件夹:系统中主硬盘文件内容和软件的副本。应用镜像至系统,可将系统恢复至创建镜像时的状态。

设置系统镜像VI在应用新镜像前,将删除终端上的已有文件。

注:  如仅需升级远程系统上的特定软件组件,可使用安装启动VI。
minibutton.gif  在程序框图上放置 minibutton.gif  在函数选板上查找

设置系统镜像(文件)

将指定终端系统中主硬盘的所有内容替换为通过创建系统镜像VI创建的镜像文件。

Set System Image (File)

cstr.gif

密码是对包含敏感信息的镜像进行加密的密码。

cbool.gif

自动重启根据终端启动流程的要求,在操作之前和/或之后重新启动系统。如果您选择不自动重新启动终端,终端的启动流程又必须处于安全模式或在操作后重新启动,则操作将失败。

cio.gif

会话句柄输入指定获取镜像的系统的系统引用句柄。

cpath.gif

源文件指定本地计算机中终端磁盘镜像文件的名称和位置。

cu32.gif

网络设置指定要在终端上应用的网络设置。

重置全部网络适配器 (0)

重置全部网络适配器为出厂默认设置。来自镜像的网络设置将被忽略。

保留主适配器,重置其他适配器 (1)

保留主网络适配器上的现有设置,重置所有其他网络适配器为出厂默认设置。来自镜像的网络设置将被忽略。

保留全部网络适配器 (2)

保留所有网络适配器的设置。来自镜像的网络设置将被忽略。

保留主适配器,应用其他适配器 (3)

(默认)保留终端上主网络适配器的设置,将镜像的设置应用至所有其他网络适配器。

应用主适配器,重置其他适配器 (4)

将镜像的设置应用于终端上的主网络适配器,重置所有其他网络适配器为出厂默认设置。

应用主适配器,保留其他适配器 (5)

将镜像的设置应用于主网络适配器,保留所有其他网络适配器的现有设置。

应用全部网络适配器 (6)

将镜像的网络设置应用至所有网络适配器。

cerrcodeclst.gif

错误输入(无错误)表明节点运行前发生的错误。该输入提供标准错误输入功能。

cbool.gif

仅原始系统验证终端系统的MAC地址与创建该镜像的系统相同。如选择TRUE,将确保恢复镜像的系统与创建该镜像的系统相同。默认值为FALSE。

c1dstr.gif

文件和目录禁用列表指定终端镜像中不包含的文件和文件夹。列表中的文件和文件夹不会从镜像复制到终端,也不会从终端移除。

范例

请考虑下列情况:

  • 镜像中有文件A、B、C、D。
  • 终端上有文件A、B、E、F。
  • 用户禁用列表中有文件A、C、E、G。

结果:

  • 即使文件A在镜像中,终端上的文件A不会被修改,因为A在禁用列表中。
  • 镜像中的文件B将覆盖终端上的文件B。
  • 镜像中的文件C不会被写至终端,因为文件C在禁用列表中。
  • 文件D被写至终端。
  • 终端上的文件E不是镜像的一部分,也不会被删除,因为它在禁用列表中。
  • 终端上的文件F被删除,因为它不是镜像的一部分。
  • 禁用列表中的文件G被忽略,因为它不在镜像中,也不在终端上。
iio.gif

会话句柄输出返回系统的引用句柄。

ierrcodeclst.gif

错误输出返回错误信息。该输出提供标准错误输出功能。

设置系统镜像(文件夹)

将指定终端系统中主硬盘的所有内容替换为通过创建系统镜像VI创建的镜像文件夹。

Set System Image (Folder)

cstr.gif

密码是对包含敏感信息的镜像进行加密的密码。

cbool.gif

自动重启根据终端启动流程的要求,在操作之前和/或之后重新启动系统。如果您选择不自动重新启动终端,终端的启动流程又必须处于安全模式或在操作后重新启动,则操作将失败。

cio.gif

会话句柄输入指定获取镜像的系统的系统引用句柄。

cpath.gif

源文件夹指定本地计算机中终端磁盘镜像文件夹的名称和位置。

cu32.gif

网络设置指定要在终端上应用的网络设置。

重置全部网络适配器 (0)

重置全部网络适配器为出厂默认设置。来自镜像的网络设置将被忽略。

保留主适配器,重置其他适配器 (1)

保留主网络适配器上的现有设置,重置所有其他网络适配器为出厂默认设置。来自镜像的网络设置将被忽略。

保留全部网络适配器 (2)

保留所有网络适配器的设置。来自镜像的网络设置将被忽略。

保留主适配器,应用其他适配器 (3)

(默认)保留终端上主网络适配器的设置,将镜像的设置应用至所有其他网络适配器。

应用主适配器,重置其他适配器 (4)

将镜像的设置应用于终端上的主网络适配器,重置所有其他网络适配器为出厂默认设置。

应用主适配器,保留其他适配器 (5)

将镜像的设置应用于主网络适配器,保留所有其他网络适配器的现有设置。

应用全部网络适配器 (6)

将镜像的网络设置应用至所有网络适配器。

cerrcodeclst.gif

错误输入(无错误)表明节点运行前发生的错误。该输入提供标准错误输入功能。

cbool.gif

仅原始系统验证终端系统的MAC地址与创建该镜像的系统相同。如选择TRUE,将确保恢复镜像的系统与创建该镜像的系统相同。默认值为FALSE。

c1dstr.gif

文件和目录禁用列表指定终端镜像中不包含的文件和文件夹。列表中的文件和文件夹不会从镜像复制到终端,也不会从终端移除。

范例

请考虑下列情况:

  • 镜像中有文件A、B、C、D。
  • 终端上有文件A、B、E、F。
  • 用户禁用列表中有文件A、C、E、G。

结果:

  • 即使文件A在镜像中,终端上的文件A不会被修改,因为A在禁用列表中。
  • 镜像中的文件B将覆盖终端上的文件B。
  • 镜像中的文件C不会被写至终端,因为文件C在禁用列表中。
  • 文件D被写至终端。
  • 终端上的文件E不是镜像的一部分,也不会被删除,因为它在禁用列表中。
  • 终端上的文件F被删除,因为它不是镜像的一部分。
  • 禁用列表中的文件G被忽略,因为它不在镜像中,也不在终端上。
iio.gif

会话句柄输出返回系统的引用句柄。

ierrcodeclst.gif

错误输出返回错误信息。该输出提供标准错误输出功能。

Log in to get a better experience