Install-FileList

Use this command to install a list of source files in the same target path. As parameter, the source files and the common target path are entered.

In case an error occurs when running this command, you can specify the option Stop script on error in the Script Editor. If the error actually occurs, the script stops, thus preventing subsequent errors.

This also applies if you set the package property Error handling to Always terminate script on error (a default setting for new packages).


Note: Starting with version 3.0 of the PPB, the Install-FileList command can also be generated by dragging and dropping more than one file or files of types, that do not create another command when dragging and dropping into the script window. If the files are already in the package directory, the source path is referenced relatively with .\, if the source files are outside the package directory, the full path is taken.


Settings:

  • Path
    • Source files
      Specifies the files to be copied including the path.
    • Target path
      Specifies the destination path for all of the files referenced in this command.
    • Use 32-Bit mode on x64 computer
      If the script is executed on a 64-bit operating system, the counterpart for 32-bit applications SysWOW64 can be used automatically when referring to the SYSTEM32 directory.
  • Replacement options
    • Always replace
      Specifies that an existing file with the same name is always overwritten.
    • Replace older versions only (Compare internal version numbers)
      This is the default option and specifies that an existing file with the same name is only overwritten if it is older than the file to be copied.
    • Never replace
      Specifies that an existing file with the same name is never overwritten.
    • Confirm replace
      An existing file with the same name is only overwritten if the user confirms this.
  • File Lock
    • Break file lock, if file is locked by the server service
      If an existing file is currently in use and therefore locked by the server service, existing handles are broken when this option is enabled. This can cause running applications that use the file to stop working.
    • Abort execution if file is locked
      Causes the execution of the script to stop if a file to be updated is locked. If the option is not enabled, the script tries to update the locked file after a restart of the computer.
  • Backup
    • Create backup files
      When the file is replaced by the copy operation, a backup copy of the existing file is created.


Example:

The following example copies the files of a package of the PPB to the specified destination directory.


Corresponds to DSM eScript command:

  • CopyFileList
  • InstallFileList


See also: