Installieren der Windows-App

• Das Windows-Installationsprogramm Password Boss ist sowohl als EXE- als auch als MSI-Datei verfügbar.
• Beide Versionen des Installationsprogramms können im Hintergrund installiert werden, indem Sie dem Installationsprogramm die unten aufgeführten Befehlszeilenparameter hinzufügen.
• Für die Erstinstallation sind Administratorrechte für den Benutzer erforderlich, es sei denn, Sie verwenden den PreInstaller über ein RMM oder ein anderes Bereitstellungstool. In diesem Fall kann die Password Boss -App ohne Administratorrechte installiert werden.
• Für nachfolgende Updates der App sind nach der Installation keine Administratorrechte erforderlich.
  • Das Windows-Installationsprogramm (EXE- und MSI-Version) besteht aus zwei Teilen. Das Stub-Installationsprogramm (EXE oder MSI) ändert sich selten und kann zu Ihren Bereitstellungstools hinzugefügt werden. Beim Ausführen des Stub-Installationsprogramms wird die neueste Version der Anwendung von unseren Servern heruntergeladen, sodass bei jeder Installation immer die neueste Version der Anwendung installiert wird.

Manuelle Installation

1. Besuchen Sie https://www.passwordboss.com/download . Die Website erkennt, welches Betriebssystem Sie verwenden, und lädt das richtige Installationsprogramm für Sie herunter.
2. Führen Sie nach dem Herunterladen des Installationsprogramms die Datei aus und folgen Sie den Anweisungen zur Installation.

RMM-Bereitstellung

Durch die Bereitstellung von Password Boss mit Ihrem RMM entfällt die Notwendigkeit, dass Endbenutzer Administratorrechte für die Installation benötigen. Der Installationsprozess erfolgt in zwei Schritten. Die Teile von Password Boss , die Administratorrechte erfordern, werden mit dem PreInstaller installiert, der als Administrator oder lokales System ausgeführt wird, und dem Haupt-Client-App-Installationsprogramm, das als Endbenutzer ausgeführt wird.

• Der PreInstaller kann vor der eigentlichen Bereitstellung der Client-App auf allen verwalteten Arbeitsstationen in großen Mengen ausgeführt werden.
• Der PreInstaller verfügt über keine Benutzeroberfläche, wird im Hintergrund installiert und nicht unter „Programme hinzufügen/entfernen“ aufgeführt.
• Der PreInstaller nimmt alle Registrierungsänderungen vor, die Administratorrechte erfordern. Der PreInstaller MUSS mit Administrator- oder lokalen Systemberechtigungen ausgeführt werden.
• Die vom PreInstaller geänderten Einstellungen können entfernt werden, indem der PreInstaller mit dem Schalter /uninstall ausgeführt wird.

Installationsschritte

1. Laden Sie das PreInstaller herunter
2. Führen Sie den PreInstaller einmal pro verwalteter Arbeitsstation über Ihr RMM aus. Für die Installation sind keine Befehlszeilen oder Parameter erforderlich.
   • Falls zur Fehlerbehebung erforderlich, können Sie die Protokollierung für den PreInstaller mit dem Parameter /verbose aktivieren. Die Protokolle werden im Ordner %TEMP% unter dem Namen PasswordBoss-PreInstall-[Datum]{Uhrzeit].log gespeichert.
3. Installieren Sie die Client-App gemäß den unten stehenden Anweisungen für die EXE- oder MSI-Bereitstellung. Die Client-App muss als Endbenutzer ausgeführt werden, sonst funktioniert die Anwendung nicht.

Allgemeine Anweisungen zur Bereitstellung per Skript

MSI

1. Laden Sie das MSI-Installationsprogramm herunter
2. Das Installationsprogramm sollte Password_Boss.msi heißen.
3. Um das Installationsprogramm im Hintergrund auszuführen, fügen Sie beim Ausführen des Installationsprogramms den Parameter EXEOPTIONS=" /q2" hinzu:

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. Um die Password Boss -App auf Remote-Geräten bereitzustellen, rufen Sie das Installationsprogramm mit der Silent-Option Ihrer bevorzugten Softwareverteilungslösung auf.
2. Das Installationsprogramm lädt während der Installation automatisch die neueste Version von Password Boss aus dem Internet herunter, sodass Ihre Benutzer immer die aktuelle Version erhalten.

PowerShell-Skriptanweisungen

Password Boss kann über PowerShell-Skripte bereitgestellt werden, alternativ zur Erstellung eines Skripts in einem RMM-Tool.

Nachfolgend finden Sie das Skript PBPreClient.ps1. Führen Sie dieses Skript in Ihrem Bereitstellungssystem zunächst als Administrator aus, bevor Sie Password Boss installieren. Dieses Skript lädt die Datei „PreInsaller.exe“ herunter und stellt sie als Administrator auf dem Computer bereit. Kopieren Sie das Skript in einen Editor und speichern Sie die Datei unter dem Namen PBPreClient.ps1, bevor Sie es verwenden.

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
}

Nachfolgend finden Sie das Skript PBClient.ps1. Führen Sie dieses Skript in Ihrem Bereitstellungssystem als angemeldeter Benutzer aus, nachdem Sie das Skript PBPreClient.ps1 erfolgreich ausgeführt haben. Dieses Skript lädt die Datei Password_Boss.exe herunter und führt sie als Benutzer aus. Kopieren Sie das Skript in einen Editor und speichern Sie die Datei unter dem Namen PBClient.ps1, bevor Sie es verwenden.

 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
}