De Windows-app installeren

• Het Windows-installatieprogramma Password Boss is beschikbaar als EXE en MSI.
• Beide versies van het installatieprogramma kunnen op de achtergrond worden geïnstalleerd door de onderstaande opdrachtregelparameters toe te voegen aan het installatieprogramma.
• Voor de eerste installatie zijn beheerdersrechten voor de gebruiker vereist, tenzij u de PreInstaller via een RMM of andere implementatietool gebruikt. In dat geval kan de Password Boss -app zonder beheerdersrechten worden geïnstalleerd.
• Voor latere updates van de app nadat deze is geïnstalleerd, zijn geen beheerdersrechten meer nodig.
  • Het Windows-installatieprogramma (zowel EXE- als MSI-versies) bestaat uit twee delen. Het stub-installatieprogramma, EXE of MSI, verandert zelden en kan aan uw implementatietools worden toegevoegd. Wanneer het stub-installatieprogramma wordt uitgevoerd, downloadt het de nieuwste versie van de applicatie zelf van onze servers, zodat elke installatie altijd de nieuwste versie van de app installeert.

Handmatige installatie

1. Ga naar https://www.passwordboss.com/download . De website detecteert welk besturingssysteem u gebruikt en downloadt het juiste installatieprogramma voor u.
2. Nadat u het installatieprogramma hebt gedownload, voert u het bestand uit en volgt u de installatie-instructies.

RMM-implementatie

Door Password Boss te implementeren met uw RMM, hoeven eindgebruikers geen beheerdersrechten meer te hebben voor de installatie. Het installatieproces bestaat uit twee stappen, waarbij de onderdelen van Password Boss die beheerdersrechten vereisen, worden geïnstalleerd met behulp van de PreInstaller, die als beheerder of lokaal systeem wordt uitgevoerd, en het installatieprogramma voor de hoofdclient-app, dat als eindgebruiker wordt uitgevoerd.

• De PreInstaller kan in bulk worden uitgevoerd op alle beheerde werkstations vóór de daadwerkelijke implementatie van de clientapp.
• De PreInstaller heeft geen gebruikersinterface, wordt stil geïnstalleerd en wordt niet vermeld in het onderdeel Software.
• De PreInstaller voert alle registerwijzigingen uit waarvoor beheerdersrechten nodig zijn. De PreInstaller MOET worden uitgevoerd met beheerders- of lokale systeemrechten.
• De door de PreInstaller gewijzigde instellingen kunnen worden verwijderd door de PreInstaller uit te voeren met de schakeloptie /uninstall.

Installatiestappen

1. Download de PreInstaller
2. Voer de PreInstaller één keer per beheerd werkstation uit met behulp van uw RMM. Er zijn geen opdrachtregels of parameters nodig voor de installatie.
   • Indien nodig voor probleemoplossing kunt u logging voor de PreInstaller inschakelen door de parameter /verbose toe te voegen. Logs worden opgeslagen in de map %TEMP% en krijgen de naam PasswordBoss-PreInstall-[Datum]{Tijd].log.
3. Installeer de client-app volgens de onderstaande instructies voor EXE- of MSI-implementatie. De client-app MOET als eindgebruiker worden uitgevoerd, anders werkt de applicatie niet voor de gebruiker.

Algemene script-implementatie-instructies

MSI

1. Download het MSI-installatieprogramma
2. Het installatieprogramma moet de naam Password_Boss.msi hebben
3. Om het installatieprogramma stil uit te voeren, voegt u de parameter EXEOPTIONS=" /q2" toe wanneer u het installatieprogramma uitvoert:

Text

/path/to/Password_Boss.msi EXEOPTIONS="/q2" 

**replace the "/path/to" with the path to where you downloaded the file to**

Text

/path/to/Password_Boss.exe /q2

**replace the "/path/to" with the path to where you downloaded the file to**

1. Als u de Password Boss -app op externe apparaten wilt implementeren, start u het installatieprogramma met de stille optie via uw favoriete softwaredistributieoplossing.
2. Tijdens de installatie downloadt het installatieprogramma automatisch de nieuwste versie van Password Boss van internet. Uw gebruikers krijgen dus altijd de meest recente versie.

PowerShell-scriptinstructies

Password Boss kan worden geïmplementeerd via PowerShell-scripts als alternatief voor het bouwen van een script in een RMM-tool.

Hieronder vindt u het script PBPreClient.ps1. Voer dit script eerst als beheerder uit in uw implementatiesysteem voordat u Password Boss installeert. Dit script downloadt PreInsaller.exe en implementeert het op de machine als beheerder. Kopieer en plak het onderstaande script in Kladblok en sla het bestand op als PBPreClient.ps1 voordat u het gebruikt.

PBPreClient.ps1

# Copyright (c) 2024 Password
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#    * Redistributions of source code must retain the above copyright
#      notice, this list of conditions and the following disclaimer.
#    * Redistributions in binary form must reproduce the above copyright
#      notice, this list of conditions and the following disclaimer in the
#      documentation and/or other materials provided with the distribution.
#    * Neither the name of the AutoElevate nor the names of its contributors
#      may be used to endorse or promote products derived from this software
#      without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL OPENDNS BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<#
.SYNOPSIS
  Installs the Password Preinstaller and Client
  #>

# Set $DebugPrintEnabled = 1 to enabled debug log printing to see what's going on.
$DebugPrintEnabled = 1

$PreInstallerName = "PBPreInstaller.exe"
$InstallerPath = Join-Path $Env:TMP $PreInstallerName
$DownloadBase = "https://install.passwordboss.com"
$DownloadURL = $DownloadBase + "/" + $PreInstallerName

$ScriptFailed = "Script Failed!"

function Get-TimeStamp {
    return "[{0:MM/dd/yy} {0:HH:mm:ss}]" -f (Get-Date)
}


function Debug-Print ($msg) {
    if ($DebugPrintEnabled -eq 1) {
        Write-Host "$(Get-TimeStamp) [DEBUG] $msg"
    }
}

function Get-PreInstaller {
    Debug-Print("Downloading installer...")
    $WebClient = New-Object System.Net.WebClient
    
    try {
        $WebClient.DownloadFile($DownloadURL, $InstallerPath)
    } catch {
        $ErrorMessage = $_.Exception.Message
        Write-Host "$(Get-TimeStamp) $ErrorMessage"
    }
    
    if ( ! (Test-Path $InstallerPath)) {
        $DownloadError = "Failed to download the Password PreInstaller from $DownloadURL"
        Write-Host "$(Get-TimeStamp) $DownloadError"
        throw $ScriptFailed
    }
    
    Debug-Print("Installer downloaded to $InstallerPath...")
}
function Install-Agent () {
    Debug-Print("Executing installer...")
        
    Start-Process $InstallerPath -Wait
    }
		
function Verify-Installation () {
    Debug-Print("Verifying Installation...")
    
    if ( ! (Get-ItemPropertyValue -Path "HKLM:\Software\PasswordBoss" -Name "PreInstall") -eq 'True') {
        $VerifiationError = "The Preinstaller installation failed!"
        Write-Host "$(Get-TimeStamp) $VerificationError"
        
        throw $ScriptFailed
    }
}

function main () {   
    Get-PreInstaller
    Install-Agent
    Verify-Installation
    
    Write-Host "$(Get-TimeStamp) PBPreinstaller successfully installed!"
}

try
{
    main
} catch {
    $ErrorMessage = $_.Exception.Message
    Write-Host "$(Get-TimeStamp) $ErrorMessage"
    exit 1
}

Hieronder vindt u het PBClient.ps1-script. In uw implementatiesysteem moet u dit script uitvoeren als aangemelde gebruiker nadat u het PBPreClient.ps1-script succesvol hebt uitgevoerd. Dit script downloadt het bestand Password_Boss.exe en voert het uit als gebruiker. Kopieer en plak het onderstaande script in Kladblok en sla het op als PBClient.ps1 voordat u het gebruikt.

 PBClient.ps1

# Copyright (c) 2022 Password
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#    * Redistributions of source code must retain the above copyright
#      notice, this list of conditions and the following disclaimer.
#    * Redistributions in binary form must reproduce the above copyright
#      notice, this list of conditions and the following disclaimer in the
#      documentation and/or other materials provided with the distribution.
#    * Neither the name of the AutoElevate nor the names of its contributors
#      may be used to endorse or promote products derived from this software
#      without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL OPENDNS BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<#
.SYNOPSIS
  Installs the Password Preinstaller and Client
  #>

# Run powershell in a clean install
# PowerShell -ExecutionPolicy Bypass

# Set $DebugPrintEnabled = 1 to enabled debug log printing to see what's going on.
$DebugPrintEnabled = 1

$InstallerName =  "Password_Boss.exe"
$InstallerPath = Join-Path $Env:TMP $InstallerName
$DownloadBase = "https://install.passwordboss.com"
$DownloadURL = $DownloadBase + "/" + $InstallerName

function Get-TimeStamp {
    return "[{0:MM/dd/yy} {0:HH:mm:ss}]" -f (Get-Date)
}

function Debug-Print ($msg) {
    if ($DebugPrintEnabled -eq 1) {
        Write-Host "$(Get-TimeStamp) [DEBUG] $msg"
    }
}

function Get-Installer {
    Debug-Print("Downloading installer...")
    $WebClient = New-Object System.Net.WebClient
    
    try {
        $WebClient.DownloadFile($DownloadURL, $InstallerPath)
    } catch {
        $ErrorMessage = $_.Exception.Message
        Write-Host "$(Get-TimeStamp) $ErrorMessage"
    }
    
    if ( ! (Test-Path $InstallerPath)) {
        $DownloadError = "Failed to download the Password Installer from $DownloadURL"
        Write-Host "$(Get-TimeStamp) $DownloadError"
        throw $ScriptFailed
    }
    
    Debug-Print("Installer downloaded to $InstallerPath...")
}
function Install-Agent () {
    Debug-Print("Executing installer...")
    
    $Arguments = "/q2"
    
    Start-Process $InstallerPath -ArgumentList $Arguments -Wait
    }
		
function Verify-Installation () {
    Debug-Print("Verifying Installation...")
  
    if ((Get-ItemProperty -Path "HKCU:\Software\PasswordBoss") -eq $null) {
        $VerifiationError = "The Installer installation failed!"
        Write-Host "$(Get-TimeStamp) $VerificationError"
        
        throw $ScriptFailed
    }
}

function main () {   
    Get-Installer
    Install-Agent
    Verify-Installation
    
    Write-Host "$(Get-TimeStamp) Password Client successfully installed!"
}

try
{
    main
} catch {
    $ErrorMessage = $_.Exception.Message
    Write-Host "$(Get-TimeStamp) $ErrorMessage"
    exit 1
}