Migrating Go Current to Update Service

Server Cmdlets

All cmdlets for the server now have a new prefix, *-Uss*, replacing the previous *-Gocs*. For instance, New-GocsPackage is now New-UssPackage.

A few of the cmdlets have been renamed to ensure a more consistent naming convention.

Few have breaking parameter changes.

To maintain compatibility with previous versions, we have established aliases for all cmdlets to ensure that your scripts remain functional with the new Update Service server, with only a few exceptions.

For further information on notable changes, see below.

Renamed Cmdlets

The following cmdlets have been renamed:

  • Copy-GocsPackagesFromServer is now Copy-UssPackageFromServer
  • Get-GocsPackage is now Get-UssPackageVersion
  • Get-GocsFile is now Get-UssPackageVersionFile
  • Get-GocsInstallerPackages is now Get-UssInstallerPackage
  • Remove-GocsPackage is now Remove-UssPackageVersion

Set-UssInstallerPackage (BREAKING)

This cmdlet has breaking parameter changes, as follows:

  • New mandatory parameter -InstallerPackageId. Specifies installer package entry to update.
  • New optional parameter -SetIndex. If set, specifies a new index for entry.
  • Removed parameter -AtIndex, replaced by -InstallerPackageId.
$Index = 1
$InstallerId = '2a2fb512-cc79-11ec-9d64-0242ac120002'

# Use
$Entry = Get-UssInstallerPackage -InstallerId $InstallerId | Select-Object -Index $Index
Set-UssInstallerPackage -InstallerId $InstallerId -InstallerPackageId $Entry.InstallerPackageId

# Instead of
Set-GocsInstallerPackage -InstallerId $InstallerId -Index $Index

Remove-UssInstallerPackage (BREAKING)

This cmdlet has breaking parameter changes, as follows:

  • New mandatory parameter `-InstallerPackageId, specifies the installer package entry to remove.
  • Removed parameter -AtIndex, replaced by -InstallerPackageId.
$Index = 1
$InstallerId = '2a2fb512-cc79-11ec-9d64-0242ac120002'

# Use
$Entry = Get-UssInstallerPackage -InstallerId $InstallerId | Select-Object -Index $Index
Remove-UssInstallerPackage -InstallerId $InstallerId -InstallerPackageId $Entry.InstallerPackageId

# Instead of
Remove-GocsInstallerPackage -InstallerId $InstallerId -AtIndex $Index

Copy-UssInstallerFromServer and Copy-UssPackageFromServer

The following parameters have been deprecated and are now ignored:

  • -SourcePort
  • -SourceUseSsl
  • -SourceIdentity

-SourceServer now accepts a URL on the form http[s]://hostname-or-dns[:port], where the old cmdlet accepts a hostname. For backward compatibility, if a hostname, i.e. localhost, is provided, it is automatically converted to http://localhost:8060*. Https is used if -SourceUseSsl is set to $true.

Common Parameter Changes (BREAKING)

All cmdlets in the old Go Current module have two common parameters, -Server and -Port, to specify the server to communicate with. The parameters have changed as follows:

  • -Server now accepts a URL on the form http[s]://hostname-or-dns[:port], where the old cmdlet accepts a hostname.
    • For backward compatibility, if a hostname, i.e. localhost, is provided, it is automatically converted to http://localhost:8060*.
  • -Port has been deprecated and is ignored.

Backward Compatibility

The old Go Current cmdlets will be disabled when you install the new Update Service server and replace them with aliases to ease the migration to the new server.

The aliases allow you to use the old cmdlet names, such as Get-GocsPackage, to interact with the new Update Service server. Meaning you do not need to change your scripts immediately with the new cmdlet names.

Disable Migration Cmdlets

If you have installed the new Update Service server, but you are not yet ready to switch over and want the cmdlets to still work with the Go Current server, you can do so:

  • To disable the migration cmdlets, run the following script as administrator:
    • C:\Program Files\LS Retail\Update Service\ServerCmdlets\VERSION\DisableCmdletsMigration.ps1
  • To re-enable migration cmdlets, run the following script as administrator:
    • C:\Program Files\LS Retail\Update Service\ServerCmdlets\VERSION\EnableCmdletsMigration.ps1