Install-Assembly

Installs a .NET assembly in a target directory or in the Global Assembly Cache (GAC). You must select an appropriate installation file. If not installed into the GAC, the target directory must also be specified.

Install-Assembly automatically detects the required .NET Framework version of the assembly and checks for this version on the computer during installation. If the required version is not present, the command is not executed.

Install-Assembly is similar to the .NET Framework tool InstallUtil.exe.

Note: Starting with version 3.0 of the PPB, the Install-Assembly command can also be generated by dragging and dropping dll files (*.dll) 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:

  • Source File
    Specifies the file to be installed including the path. Variables are allowed. Use the "..." button to select an existing file (on the packaging system) or enter the path manually.
  • Install assembly into Global Assembly Cache (GAC)
    Enabling this option causes the selected .NET assembly to be installed in the GAC. This eliminates the need to specify the installation target.
    • Uninstall all available versions in GAC
      If the assembly is to be installed in the GAC, this additional option is available. When enabled, existing versions of the selected .NET assembly are uninstalled from the GAC. Only the newly installed version is then available.
  • Target File
    Specifies the target file(s) including path.
  • Overwrite Options
    • Always overwrite
      This is the default option and specifies that existing files with the same name are always overwritten.
    • Overwrite older versions only
      This option specifies that existing files with the same name are only overwritten if they are older than the file to be copied.
    • Never overwrite
      Specifies that existing files with the same name are never overwritten.
    • Confirm overwriting
      Existing files with the same name are only overwritten if the user confirms this.
  • File Lock
    • Break file lock, if file is locked by server service
      If the existing assembly 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 assembly to stop working.
  • Backup
    • Create backup file
      When files are replaced by the installation, a backup copy of the existing files is created.
  • .Net Installer Class
    • Execute installation with following parameters
      If you want to install the .NET assembly with certain parameters, they must be specified here.


Example:

The following example installs the assembly of our product "PowerShell Extensions for Ivanti DSM" into the Global Assembly Cache and at the same time removes any older versions.


Corresponds to DSM eScript command:

  • InstallAssembly


See also: