PowerShell module

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name navcontainerhelper -RequiredVersion

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deloy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More


Freddy Kristiansen


(c) 2017 Freddy Kristiansen. All rights reserved.



Add-FontsToNavContainer Backup-NavContainerDatabases Check-NavContainerHelperPermissions Compile-AppInNavContainer Compile-ObjectsInNavContainer Convert-AlcOutputToAzureDevOps Convert-ModifiedObjectsToAl Convert-Txt2Al Copy-CompanyInNavContainer Copy-FileFromNavContainer Copy-FileToNavContainer Create-AlProjectFolderFromNavContainer Create-MyDeltaFolder Create-MyOriginalFolder Create-AadAppsForNav Create-AadUsersInNavContainer Download-File Enter-NavContainer Export-ModifiedObjectsAsDeltas Export-NavContainerDatabasesAsBacpac Export-NavContainerObjects Extract-AppFileToFolder Extract-FilesFromNavContainerImage Extract-FilesFromStoppedNavContainer Generate-SymbolsInNavContainer Get-BestNavContainerImageName Get-CompanyInNavContainer Get-LocaleFromCountry Get-NavContainerApiCompanyId Get-NavContainerApp Get-NavContainerAppInfo Get-NavContainerAppRuntimePackage Get-NavContainerCountry Get-NavContainerDebugInfo Get-NavContainerEula Get-NavContainerEventLog Get-NavContainerGenericTag Get-NavContainerId Get-NavContainerImageLabels Get-NavContainerImageName Get-NavContainerImageTags Get-NavContainerIpAddress Get-NavContainerLegal Get-NavContainerName Get-NavContainerNavUser Get-NavContainerNavVersion Get-NavContainerOsVersion Get-NavContainerPath Get-NavContainerPlatformVersion Get-NavContainers Get-NavContainerServerConfiguration Get-NavContainerSession Get-NavContainerSharedFolders Get-NavContainerTenants Get-NavVersionFromVersionInfo Get-TestsFromNavContainer Import-ConfigPackageInNavContainer Import-DeltasToNavContainer Import-NavContainerLicense Import-ObjectsToNavContainer Import-PfxCertificateToNavContainer Import-TestToolkitToNavContainer Install-NavContainerApp Install-NAVSipCryptoProviderFromNavContainer Invoke-NavContainerApi Invoke-NavContainerCodeunit Invoke-ScriptInNavContainer New-CompanyInNavContainer New-DesktopShortcut New-LetsEncryptCertificate New-NavContainer New-NavContainerNavUser New-NavContainerTenant New-NavContainerWindowsUser Open-NavContainer Publish-NavContainerApp Publish-NewApplicationToNavContainer Remove-CompanyInNavContainer Remove-ConfigPackageInNavContainer Remove-DesktopShortcut Remove-NavContainer Remove-NavContainerSession Remove-NavContainerTenant Renew-LetsEncryptCertificate Repair-NavContainerApp Replace-NavServerContainer Restart-NavContainer Run-TestsInNavContainer Setup-NavContainerTestUsers Setup-TraefikContainerForNavContainers Sign-NavContainerApp Start-NavContainer Start-NavContainerAppDataUpgrade Stop-NavContainer Sync-NavContainerApp Test-NavContainer UnInstall-NavContainerApp UnPublish-NavContainerApp Wait-NavContainerReady Write-NavContainerHelperWelcomeText


This module has no dependencies.

Release Notes
Added parameter appName to Compile-AppInNavContainer to allow you to specify an app name instead of the default
Added some debugging output to Compile-ObjectsInNavContainer
Changing the default tenant to use the default tenant (not the tenant template) to export as bacpac in Export-NavContainerDatabasesAsBacpac
Check that the tenant exported in Export-NavContainerDatabasesAsBacpac is operational before exporting
Fix bug #492 - Publish-NavContainerApp deletes the App file
Remove .git folder and other files, which should not be published
Added function Get-NavContainerApp to download an app or symbols from a container
Added function Extract-AppFileToFolder to extract the content of an App Package to a Folder
Prepare NavContainerHelper for BC containers (without C/AL and without Windows Client)
Support for 1903 generic image ( with -useBestContainerOS
Improve Traefik Security by disallowing port 8080 on host (Thanks Damien Duportal)
Add ForceSync sync mode and Language parameter to Publish-NavContainerApp (Thanks Martin Kuhn)
Additional rebranding for NAV/BC containers
Reverted the change to default to hyperv isolation if the revision number is different. Instead, just write a warning to maybe specify -isolation hyperv.
Added support for traefik (Thanks Tobias Fenster)
Added BCContainer aliases for all functions with NavContainer in the name (which are not C/AL functions)
Functions working on C/AL objects will not work with version 15.0 and higher
Remove functions Convert-CALExecutionTimeToTimeSpan and Convert-CALTestOutputToAzureDevOps
Fix: UnInstall and UnPublishNavContainerApp didn't transfer the value of doNotSaveData to the underlying cmdlet
Added parameter Force to UnInstall and UnPublishNavContainerApp
Fix: Backup-NavContainerDatabases added another mediaset if the file already exists, making the backup useless for creating containers.
Added parameter BakFile to New-NavContainer to specify bakFile when starting container
Added parameter UseGenericImage to New-NavContainer to allow for using private generic docker images for re-platforming and running container.
New-NavContainer defaults to hyperv isolation if the Host OS version differs from the Container OS version (incl. release number = new)
Move the git piece of Create-AlProjectFromNavContainer to the end. If this fails, then everything is still created correctly.
Create txt files for platform, version and country when extracting files from a container and use those (if existing) when spinning up a generic image.
Support for Windows 10 1903 preview
Bugfix: Publish-NewApplicationToNavContainer was hardcoded to use CRONUS as database - must take databasename from customsettings
Fix: Event Sources is missing for WebClient in Nav 2018 and Business Central Containers (prior to generic tag, causing the WebClient to crash if an entry is added to the event log.
Regression: Compile-AppInNavContainer should not add defaulting for AssemblyProbingPaths for versions prior to 13.x
Test-NavContainer and Get-NavContainerId should now be case insensitive
Get-NavContainers now use a single docker statement instead of multiple calls
Include WindowsPowerShellScripts\WebSearch\TransitionMenuSuiteObjectsForSearch.psm1 if it exists when extracting files from container
BugFix: Run-TestsInNavContainer didn't use the users company setting when running Windows Authentication
Added parameter CompanyName to Run-TestsInNavContainer
Ignore License expiration warning lines when running Get-CompanyInNavContainer when the user is not running when admin priveleges
Ignore License expiration warning lines when running Get-NavContainerNavUser when the user is not running when admin priveleges
Regression: Export-NavContainerObjects didn't respect filter containing id in 14.x
Use DacFramework 18.2
BugFix: Create-AlProjectFromNavContainer used a global imageName, should be containerName
BugFix: Regression - 14.x images has hidden dependency to app symbols
Add parameter for file pattern to Convert-ModifiedObjectsToAl in order to allow for app movement
Bugfix #423 Regression in Convert-Txt2Al $imageName is unknown
Bugfix #421 Export-NavContainerDatabasesAsBacpac error deleting [user login] data
Added parameter enableSymbolLoading to Replace-NavServerContainer
Regression in Export-NavContainerObjects fixed - $imagename unknown
New function Extract-FilesFromStoppedNavContainer to extract (copy) files from a stopped container
Regression in Compile-AppInNavContainer when running container prior to 14.x
BugFix #403: Extract-FilesFromNavContainer didn't work with all local containers
Include ClientContext.ps1, PsTestFunctions.ps1 and pstesttoolpage.fob in NavContainerHelper instead of downloading on demand
Add enableSymbolLoading option to Replace-NavServerContainer
Compile-AppInNavContainer should only include dependencies in app.json
Drop View deadlock_report_ring_buffer_view when creating bacpac using Export-NavContainerDatabasesAsBacpac
UpdateHosts will update hosts file in the container with all entries ending with .docker.internal from the host
Enable paging in Get-NavContainerImageTags
Add parameter networkName to Get-NavContainerIpAddress or get IP address from first network with IP Address
Add IncludeSystemObjects parameter to Export-NavContainerObjects
Add parameters doNotUseDeltas and alProjectFolder to Convert-ModifiedObjectsToAl
Add parameter -includeAL to New-NavContainer to create AL source folder and .netpackages folder with reference assemblies for VS Code
Add parameters nowarn and assemblyProbingPaths to Compile-AppInNavContainer. Default assemblyProbingPaths is .netpackages in the project folder and all dll locations in the container
Add parameter dotNetAddInsPackage to Convert-ModifiedObjectsToAl and Convert-Txt2Al
New function Publish-NewApplicationToNavContainer to publish an app including base app to a container
New function Create-AlProjectFolderFromNavContainer to create a VS Code AL Project Folder based on a Container
Bugfix #413: Copy-CompanyInNavContainer throws strange exception
BugFix: Regression in Compile-AppInNavContainer when using NavUserPassword
BugFix #391 [Devops Pipeline].[Compile-App] publisher property not found
Added parameter rulesetFile to Compile-AppInNavContainer
BugFix #382 Compile-AppInNavContainer cannot download symbols on containers without updated hosts
Breaking change: Setup-NavContainerTestUsers has a changed parameter set (specify admin crendential instead of sql credential)
Added function: Get-NavContainerApiCompanyId to get the CompanyId for Api Calls
Added function: Invoke-NavContainerApi to invoke Api calls towards a container
Changed Compile-AppInNavContainer to use the container IP address for downloading symbols
Bugfix: Regression in Convert-ModifiedObjectsToAl
BugFix #380: Remove WinClient Debugger shortcut
Publish and install an app instead of a codeunit when adding test users to Business Central
Support Groups in Run-TestsInNavContainer
Create AL baseline for database objects when version 14 (Spring Release)
Added parameter -doNotUseDeltas to Convert-ModifiedObjectsToAl to create complete AL files of the objects exported
Added parameters testCodeunit and testFunction to Run-TestsInNavContainer to run individual tests
Added function Get-TestsFromNavContainer to get a list of available tests
Added a shortcut for the WinClient Debugger when using includecside
Include ImportAction to Import-TestToolKitToNavContainer and Import-ObjectsToNavContainer
Check that NavContainerHelper is running in 64bit mode
Remove Symbols for Application and Test when running containers in hybrid development
Use application version number from dbproperty database for application symbols (if possible)
BugFix: Transfer AzureDevOps parameter to PsTestRunner
Add paging to Get-NavContainerImageTags (needed for Azure Container Registries)
Do not allow c:\programdata\navcontainerhelper as the folder in Export-NavContainerObjects
BugFix #355 - Add-FontsToNavContainer fails if the folders doesn't have the same path
Added function Run-TestsInNavContainer (preview)
Update help text for Copy-FileToNavContainer and Copy-FileFromNavContiner and throw an error if the destination filename specifies a folder
Added function Copy-CompanyInNavContainer (Thanks Dmitry K.)
Bugfix: Compile-AppInNavContainer didn't escape the publisher name
Bugfix: All User data wasn't cleaned up when doing Export-NavContainerDatabasesAsBacpac
Fix bug where Get-BestNavContainerImageName returns an illegal image name
Support for running NavContainerHelper without elevated permissions
Added function Check-NavContainerHelperPermissions to test whether you have the needed permissions to run NavContainerHelper
Added function Repair-NavContainerApp
Added function Invoke-ScriptInNavContainer to invoke a PowerShell script in a Nav Container
Added function Get-NavContainerAppRuntimePackage to download a runtime package for an app from a container
Added function Get-NavContainerImageLabels to get the labels for an image directly from the registry
Added function Get-NavContainerImageTags to get the available tags a repository directly from the registry
Added parameter doNotUpdateSymbols to Import-TestToolkitToNavContainer to avoid symbol generation
Check Docker OS in New-NavContainer for better error messages
Fix timestamp in file name for Get-NavContainerEventLog

Version History

Version Downloads Last updated 124 10/18/2019 2,951 10/12/2019 2,887 10/7/2019 388 10/6/2019 35 10/6/2019 163 10/5/2019 2,366 9/29/2019 978 9/26/2019 1,215 9/21/2019 586 9/19/2019 3,286 9/8/2019 154 9/6/2019 1,656 9/2/2019 435 9/2/2019 549 8/30/2019 1,371 8/26/2019 168 8/26/2019 1,967 8/18/2019 144 8/16/2019 368 8/15/2019 1,312 8/8/2019 1,652 8/2/2019 823 7/31/2019 662 7/28/2019 2,400 7/15/2019 1,652 7/6/2019 1,170 7/2/2019 757 6/27/2019 571 6/26/2019 163 6/25/2019 998 6/19/2019 1,029 6/16/2019 377 6/14/2019 (current version) 276 6/13/2019 1,246 6/6/2019 2,357 5/24/2019 518 5/23/2019 4,225 5/3/2019 470 4/30/2019 544 4/27/2019 398 4/25/2019 177 4/24/2019 105 4/24/2019 587 4/19/2019 234 4/17/2019 934 4/14/2019 321 4/12/2019 69 4/11/2019 12 4/11/2019 202 4/11/2019 142 4/11/2019 4 4/11/2019 27 4/10/2019 3,491 3/27/2019 31 3/27/2019 1,385 3/19/2019 196 3/18/2019 2 3/18/2019 2,614 3/6/2019 632 3/4/2019 1,028 2/27/2019 355 2/25/2019 3,606 2/6/2019 1,253 1/30/2019 157 1/29/2019 2,187 1/17/2019 167 1/17/2019 840 1/13/2019 4,266 12/11/2018 77 12/11/2018 179 12/10/2018 1,210 12/4/2018 641 11/30/2018 41 11/30/2018 161 11/30/2018 3,212 11/16/2018 137 11/16/2018 369 11/15/2018 1,738 11/5/2018 2,315 10/28/2018 2,168 10/23/2018 6,997 9/30/2018 2,195 9/22/2018 799 9/18/2018 701 9/16/2018 2,329 9/2/2018 6,952 7/9/2018 229 7/6/2018 986 6/28/2018 845 6/23/2018 81 6/22/2018 242 6/21/2018 241 6/19/2018 8 6/19/2018 1,299 6/10/2018 6 6/10/2018 545 6/6/2018 5,932 4/12/2018 16 4/12/2018 30 4/12/2018 10 4/12/2018 9 4/12/2018 17 4/11/2018 556 4/5/2018 312 4/2/2018 732 3/22/2018 3 3/22/2018 300 3/19/2018 2,483 3/6/2018 21 3/6/2018 3 3/6/2018 12 3/5/2018 33 3/5/2018 496 2/24/2018 483 2/16/2018 82 2/16/2018 20 2/16/2018 9 2/15/2018 3 2/15/2018 2,032 2/3/2018 8 2/3/2018 835 1/8/2018 4 1/8/2018 1,151 12/19/2017 105 12/16/2017 294 12/12/2017 748 11/30/2017 37 11/30/2017 65 11/29/2017 83 11/27/2017 1,748 11/12/2017 31 11/11/2017 227 11/9/2017 33 11/9/2017 521 11/7/2017 150 11/7/2017 4 11/7/2017 4 11/7/2017 39 11/6/2017 37 11/6/2017 388 11/3/2017 237 10/26/2017 6 10/26/2017 7 10/26/2017 208 10/21/2017 3 10/21/2017 4 10/21/2017 15 10/21/2017
Show less