Migration from installer to PowerShell

8min
Please note:
The instructions describe how to prepare and migrate Passwork, installed using the Passwork installer or manually, to the PowerShell module.
The instructions are for a single Passwork installation and are not suitable for a fault-tolerant solution.
Preparation
Open PowerShell as "Administrator":
Right-click on the Start icon in the lower left corner of the screen.
Select "Windows PowerShell (Administrator)" from the context menu.
Left-click on the Start icon in the lower left corner of the screen.
Write powershell
Open PowerShell as "Administrator" with the combination — Ctrl + Shift + Enter
When using Windows Server 2016, you must enable the TLS 1.2 security protocol using the command:
PowerShell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
﻿
Get the PassworkModule.zip archive into the current directory:
PowerShell
if (-not (Test-Path "$pwd\PassworkModule.zip")) {
    (New-Object System.Net.WebClient).DownloadFile(
        "https://repos.passwork.pro/repository/powershell/PassworkModule.zip", 
        "$pwd\PassworkModule.zip"
    )
    Write-Host "Module successfully received" -ForegroundColor Green
} else {
    Write-Host "Archive with the module already exists" -ForegroundColor Red
}
if (-not (Test-Path "$pwd\PassworkModule.zip")) {
    (New-Object System.Net.WebClient).DownloadFile(
        "https://repos.passwork.pro/repository/powershell/PassworkModule.zip", 
        "$pwd\PassworkModule.zip"
    )
    Write-Host "Module successfully received" -ForegroundColor Green
} else {
    Write-Host "Archive with the module already exists" -ForegroundColor Red
}
﻿
In case of errors, the archive can be downloaded manually: https://repos.passwork.pro/repository/windows-powershell/PassworkModule.zip﻿
Unzip the PowerShell module:
PowerShell
# Get the location of PowerShell modules
$windowsModulePaths = $env:PSModulePath -split ";" | Where-Object { $_ -like "C:\Windows*" }

# Unzip the PowerShell module to the directory
Expand-Archive `
    -Path "$pwd\PassworkModule.zip" `
    -DestinationPath $windowsModulePaths -Force

# Delete the PassworkModule.zip archive
Remove-Item "$pwd\PassworkModule.zip"
# Get the location of PowerShell modules
$windowsModulePaths = $env:PSModulePath -split ";" | Where-Object { $_ -like "C:\Windows*" }

# Unzip the PowerShell module to the directory
Expand-Archive `
    -Path "$pwd\PassworkModule.zip" `
    -DestinationPath $windowsModulePaths -Force

# Delete the PassworkModule.zip archive
Remove-Item "$pwd\PassworkModule.zip"
﻿
Migration
Description
Migration will collect and record information about the components used in a separate file, remove the Passwork installer, and add the ability to use administration features.
Start migration process
Run the migration:
PowerShell
Set-Passwork-PowerShell
Set-Passwork-PowerShell
﻿
PassworkSetup.exe processing
Passwork website processing
Getting the Passwork version in use
Certificate Validation
PHP processing
Processing MongoDB
Handling Start Menu Shortcuts and Desktop links
The script will create a file called C:\inetpub.passwork_component, which contains the details that are needed for the PowerShell module to work correctly:
﻿
PowerShell
PASSWORK_SETUP = 1 
PS_REMOVE = 1
SITE_NAME = Passwork Web Site
PHYSICAL_PATH = C:\inetpub\wwwroot\passwork
PASSWORK_VERSION = 060403
CERT = XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
PHP_VERSION = 8.0.20
DB_VERSION = 4.2.9
DB_CONFIG = C:\Program Files\MongoDB\Server\4.2\bin\mongod.cfg 
DB_ROOT = C:\Program Files\MongoDB
MIGRATE = 1
PASSWORK_SETUP = 1 
PS_REMOVE = 1
SITE_NAME = Passwork Web Site
PHYSICAL_PATH = C:\inetpub\wwwroot\passwork
PASSWORK_VERSION = 060403
CERT = XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
PHP_VERSION = 8.0.20
DB_VERSION = 4.2.9
DB_CONFIG = C:\Program Files\MongoDB\Server\4.2\bin\mongod.cfg 
DB_ROOT = C:\Program Files\MongoDB
MIGRATE = 1
﻿
﻿
Updated 23 Jan 2025
Did this page help you?
Migration from Windows to Docker
About config.ini