Update Service

Last updated: 2026-03-23

Table of contents

  1. Update Service
    1. Used Variables
    2. Modules Management
      1. Importing BC cmdlets from a Update Service instance
    3. Install a local LS Central Instance with Demo Data
      1. Install the Update Service Module

Used Variables

$InstanceName = “POS” # or “POSMaster”, for example

Modules Management

Importing BC cmdlets from a Update Service instance

Import-Module (Get-BcModulePath -InstanceName <InstanceName> -Type <Module type>) -Global

  • Change InstanceName to match the Update Service instance (not the Business Central Service instance name)
  • Module type: Management, Apps

Imports the Business Central Powershell modules from a Business Central installed using Update Service.

Example:

$InstanceName = 'POS'

Import-Module LsSetupHelper\BusinessCentral\Management

Import-Module (Get-BcModulePath -InstanceName $InstanceName -Type Management) -Global
Import-Module (Get-BcModulePath -InstanceName $InstanceName -Type Apps) -Global

From: go-current-examples/LSCentral/Scripts/Import-BcPsModules.ps1 at master · lsretail/go-current-examples

Install a local LS Central Instance with Demo Data

Run the following script in an elevated PowerShell console (Run as Administrator):

$ErrorActionPreference = 'stop'
Import-Module UpdateService

$InstanceName = 'LSCentral28Dev'    # Name it as you want

$Arguments = @{
  'bc-server' = @{
      AllowSessionCallSuspendWhenWriteTransactionStarted = 'true'
  }
}

$Packages = @(
              # Optional, uncomment to include:
              # @{ Id = 'sql-server-developer-advanced'; VersionQuery = '^-' }
              @{ Id = 'ls-central-demo-database'; VersionQuery = '*^ >=28.0' }
              @{ Id = 'bc-web-client'; VersionQuery = '' }
              @{ Id = 'ls-central-app'; VersionQuery = '*^ >=28.0' }
)

Write-Host "Installing the following packages:"
$Packages | Get-UscUpdates -InstanceName $InstanceName | Format-Table -AutoSize | Out-String | Write-Host

$Packages | Install-UscPackage -InstanceName $InstanceName -UpdateStrategy 'Manual' -Arguments $Arguments

Install the Update Service Module

If you get an error when importing the Update Service module, run the following script to download and install it:

$ErrorActionPreference = 'stop'
$Url = 'https://updateservice.lsretail.com/api/v1/installers/00000000-0000-0000-0000-000000000000/download'
$OutputPath = (Join-Path ([IO.Path]::GetTempPath()) 'UpdateServiceClientInstall.exe')
Write-Host 'Downloading Update Service client...'
Invoke-WebRequest -Uri $Url -OutFile $OutputPath

Write-Host 'Installing Update Service client...'
& $OutputPath --Silent | Out-Null
$env:PSModulePath = [System.Environment]::GetEnvironmentVariable('PSModulePath', 'Machine')
Remove-Item $OutputPath -Force -ErrorAction SilentlyContinue

Close and reopen the PowerShell console after installing for the module to be properly loaded.


This site uses Just the Docs, a documentation theme for Jekyll.