Skip to content

Deployment

Jakub Šindelář edited this page Sep 12, 2020 · 6 revisions

We provide EXE installer, which may be deployed and customized with command line arguments, allowing you to deploy it automatically with tools like SCCM. You can download latest installer on Release page. Lazy Admin comes with automatic updates, which will check for updates, downloads and installs them once you close application, making for effortless and painless management.

Installation command line parameters

#f03c15 WARNING

We use NSIS as installer provider, which works, but carries some caveats:

  • Parameters /S and /D are case sensitive
  • Installation path paramater /D must be last parameter if used

Silent installation

#f03c15 WARNING
Parameter is case sensitive

Parameter syntax
/S

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /S
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/S'

Installs silently and does not open application after installation. Default behavior is passive install and application opens afterwards.

Master definition URL

Parameter syntax
/URL="{URL}"

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /URL="http://share.contoso.local/master-definition.json"
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/URL="http://share.contoso.local/master-definition.json"'

Sets master definition URL in HKLM\SOFTWARE\Lazy Admin\MasterDefinitionUrl.
If parameter is not supplied and registry value does not exist, installation sets URL to example definition in this repository. Preferably should be set with GPO. Path to file can point to local file, network file or network URL.

Custom translation URL

Parameter syntax
/LANGURL="{URL}"

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /LANGURL="http://share.contoso.local/de-de.json"
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/LANGURL="http://share.contoso.local/de-de.json"'

Sets custom translation URL in HKLM\SOFTWARE\Lazy Admin\CustomLanguageUrl.
If parameter is not supplied, no registry value is created. Custom translation is not necessary, you can use languages already present in application. If you want to create your own translation, refer to Custom Translation. Path to file can point to local file, network file or network URL.

Install PowerShell Core

Parameter syntax
/InstallPwsh

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /InstallPwsh
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/InstallPwsh'

Downloads and executes Microsoft's install script, which attempts to download and install MSI of latest PowerShell Core.

Install Credential Manager Module

Parameter syntax
/InstallCredMgr

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /InstallCredMgr
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/InstallCredMgr'

Executes Install-Module -Name CredentialManager -Scope AllUsers -Force, which should install CredentialManager Module. This module is used by Application to securely save and fetch credentials to create PowerShell session. It is not required to use this module, but it makes Lazy Admin more convenient to use.

Set Windows Code page to UTF8

Parameter syntax
/SetUtf8

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /SetUtf8
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/SetUtf8'

Changes Windows' Code page to UTF8. Electron application expects only UTF8, thus passing and receiving anything from PowerShell with different CodePage may brake special characters. It should not be problem with English version of Windows. If you experience problems with your locale, try this parameter. Refer to Setup environment.

Import Houby Studio certificate

Parameter syntax
/ImportCert

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /ImportCert
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/ImportCert'

Imports Houby Studio's root certificate to trusted certificate store. This is not required at all and serves only minor function. You may want to import certificate if you want to validate executable's signature on application launch on UAC prompt.

Custom install directory

#f03c15 WARNING
Parameter is case sensitive and must be used as last parameter

Parameter syntax
/D={CustomPath}

Example
CMD
".\Lazy-Admin-Setup-X.X.X.exe" /D="C:\CompanyApps\LazyAdmin"
PowerShell
Start-Process -FilePath ".\Lazy-Admin-Setup-X.X.X.exe" -ArgumentList '/D="C:\CompanyApps\LazyAdmin"'

Installs directly to target directory, without any additional subfolders, in example above, main application would end up in:
C:\CompanyApps\LazyAdmin\Lazy Admin.exe

#c5f015 Note: If you use this parameter, you must use it as last parameter, as NSIS will treat anything after /D= as installation path.

Clone this wiki locally