Voice: Command Line Silent Installation
  • 4 Minutes to read
  • Dark
    Light

Voice: Command Line Silent Installation

  • Dark
    Light

Article Summary

nVoq Voice can be installed for a group of users via command line interface using either an executable file (voice.exe) or a Microsoft Windows Installer file (voice.msi).

Using an MSI file there is no way to specify a target directory for installation. You can do this using the EXE installer.
With the MSI file you cannot edit where the Voice properties and updater are stored on the user's machine.

These commands can be run by your preferred deployment software to perform mass deployments of Voice.

Voice.msi

Using an MSI file, nVoq Voice can be deployed using Microsoft Group Policy, which requires that the application setup is authored as a Windows Installer (.msi) package.

Install Voice.msi via Command Line

There is no way to specify a target directory for installation. You can do this using the EXE installer. With the MSI file you cannot edit where the Voice properties and updater are stored on the user's machine.
A new MSI file is created for each new release of Voice.
The MSI file will only install the version of Voice that it corresponds to. However, once Voice is installed, updates to the application can occur as described in Voice: Install Updates - nVoq Voice Help.
  1. Before installing, make sure all versions of Voice are removed. See Voice Uninstallation
  2. Download the MSI file at https://{system}/voice/msi replacing {system} with the system from which your users launch nVoq products (for example https://healthcare.nvoq.com/voice/msi or https://canada.nvoq.com/voice/msi). The file is 78.0 MB.
  3. Run the Command Prompt application as an administrator.
  4. Change the directory to where voice.msi was downloaded in Step 2 (for example cd C:\Users\USERNAME\Downloads).
cd C:\Users\USERNAME\Downloads
  1. Run  msiexec /i voice.msi /qn 
msiexec /i voice.msi /qn
  1. Upon installation:
    • Files are saved in three locations:
      1. The application itself is installed at C:\Users\[username]\AppData\Local\Programs\nvoq-voice
      2. Files for user properties, logs, and cached items for improved performance are installed at C:\Users\[username]\AppData\Roaming\nvoq-voice (This file location cannot be changed.)
      3. Files for automatic updates are installed at C:\Users\[username]\AppData\Local\nvoq-voice-updater (This file location cannot be changed.) 
    • The installer installs a desktop shortcut for nVoq Voice on the user machine.
    • When Voice is initially deployed using the MSI installer, the application is listed in Add or Remove Programs just as "voice" with no build number.
    • When a new build of Voice is available it is downloaded automatically and then installed the next time the application is closed and reopened. An additional entry appears in Add or Remove Programs after the update is installed and is displayed with a build number (voice {build}). 

Uninstall Voice.msi via Command Line

  1. Before uninstalling nVoq Voice, close the Voice application
  2. Run the silent uninstall command from the location where the MSI file is located:  msiexec /x voice.msi /qn 
    • This uninstaller removes the Voice application and the desktop shortcut, but the directory at C:\Users\[USERNAME]\AppData\Roaming\nvoq-voice and all user data remains.
    • Additionally, if the application was ever updated to a new build, another Voice entry is displayed in end-user's Add or Remove Programs after the update was installed. An additional uninstall command can be run to remove the update entry as well as user data (see Step 3 below). 
msiexec /x voice.msi /qn
  1. Run a second uninstall command:  C:\Users\[USERNAME]\AppData\Local\Programs\nvoq-voice>"Uninstall voice.exe" /S
    • This uninstaller only works if there has been an update to nVoq Voice and will remove that additional Voice entry that is displayed in the end-user's Add or Remove Programs after the update was installed.
    • This uninstaller also removes the nvoq-voice directory at C:\Users\[USERNAME]\AppData\Roaming\
C:\Users\[USERNAME]\AppData\Local\Programs\nvoq-voice>"Uninstall voice.exe" /S


Voice.exe

Install Voice.exe via Command Line

Using an EXE file, nVoq Voice can be deployed to a specific directory on user machines.

A new EXE file is created for each new release of Voice.
The EXE file will only install the version of Voice that it corresponds to. However, once Voice is installed, updates to the application can occur as described in Voice: Install Updates - nVoq Voice Help.
  1. Before installing, make sure all versions of nVoq Voice are removed. See Voice Uninstallation 
  2. Download nVoq Voice at https://{system}/voice/voice.exe replacing {system} with the system from which your users launch nVoq products (for example https://healthcare.nvoq.com/voice or https://canada.nvoq.com/voice)
  3. Run the Command Prompt application as an administrator 
  4. Change the directory to where voice.exe was downloaded in Step 2 (for example cd C:\Users\USERNAME\Downloads).
cd C:\Users\USERNAME\Downloads
  1. We recommend using the command below to create a new folder for the Voice files. 
    Run voice.exe /NCRC /S /D="{install_dir}replacing {install_dir} with the location where the Voice files will reside, making sure to include the new directory/folder name for the files (for example voice.exe /NCRC /S /D="C:\Program Files\nVoqVoice")
voice.exe /NCRC /S /D="{install_dir}"
Using the example above this command will CREATE a folder called nVoqVoice inside the Program Files directory (assuming you do not already have a file with that name in that directory). 
  • /NCRC disables the CRC check, unless CRCCheckforce was used in the script.
  • /S runs the installer or uninstaller silently. See section 4.12 at https://nsis.sourceforge.io/Docs/Chapter3.html#3.2.1 for more information.
  • /D sets the default installation directory ($INSTDIR), overriding InstallDir and InstallDirRegKey. It must be the last parameter used in the command line and must not contain any quotes, even if the path contains spaces. Only absolute paths are supported.
  1. You will see the nVoq Voice desktop shortcut which can be used to launch Voice from the {install_dir}. When a new build is available, it is downloaded automatically and then installed the next time the application is closed and reopened.

Uninstall Voice.exe via Command Line

  1. Before uninstalling nVoq Voice, close the Voice application 
  2. Run the silent uninstall command Uninstall voice.exe from the {install_dir} location (for example "c:\Program Files\nVoqVoice\Uninstall voice.exe" /S).
    Using the example command, the entire nVoqVoice FOLDER will be removed.

"c:\Program Files\nVoqVoice\Uninstall voice.exe" /S
  1. The nVoq Voice desktop shortcut and program files are removed.