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.



Compile-ObjectsInNavContainer Convert-ModifiedObjectsToAl Convert-Txt2Al Copy-FileFromNavContainer Copy-FileToNavContainer Create-MyDeltaFolder Create-MyOriginalFolder Create-AadAppsForNav Download-File Enter-NavContainer Export-ModifiedObjectsAsDeltas Export-NavContainerDatabasesAsBacpac Export-NavContainerObjects Get-LocaleFromCountry Get-NavContainerAppInfo Get-NavContainerCountry Get-NavContainerDebugInfo Get-NavContainerEula Get-NavContainerEventLog Get-NavContainerGenericTag Get-NavContainerId Get-NavContainerImageName Get-NavContainerIpAddress Get-NavContainerLegal Get-NavContainerName Get-NavContainerNavVersion Get-NavContainerOsVersion Get-NavContainerPath Get-NavContainers Get-NavContainerSession Get-NavContainerSharedFolders Get-NavVersionFromVersionInfo Import-DeltasToNavContainer Import-NavContainerLicense Import-ObjectsToNavContainer Import-TestToolkitToNavContainer Install-NavContainerApp Install-NAVSipCryptoProviderFromNavContainer New-CSideDevContainer New-DesktopShortcut New-NavContainer New-NavContainerNavUser New-NavContainerTenant New-NavContainerWindowsUser Open-NavContainer Publish-NavContainerApp Remove-DesktopShortcut Remove-NavContainer Remove-NavContainerSession Remove-NavContainerTenant Replace-NavServerContainer Start-NavContainerAppDataUpgrade Sync-NavContainerApp Test-NavContainer UnInstall-NavContainerApp UnPublish-NavContainerApp Wait-NavContainerReady Write-NavContainerHelperWelcomeText


This module has no dependencies.

Release Notes
BugFix: ExportTxtSkipUnlicensed doesn't get set in Export-NavContainerObject when using NavUserPassword authentication
Added -compile switch to Import-DeltasToNavContainer
Added -deltaFolder to Export-ModifiedObjectsAsDeltas
Increased timeout in Wait-NavContainerReady
Bugfix: Get-LocaleFromCountry returned blank for finnl and a lot of other finxx localizations
Add -settings on Windows Client shortcut to ensure correct clientsettings.config usage
Silence output of clearing modified flag
Add function Import-NavContainerLicense
Add parameters -sync and -install to Publish-NavContainerApp
Add filter parameter to Convert-ModifiedObjectsToAl and Export-ModifiedObjectsAsDeltas (default is Modified=1)
Support for inline scripts, URLs and .zip files in myscripts on New-NavContainer
Bugfix: Remove-NavContainer doesn't remove entries in hosts file
Remove-NavContainer to fail if it cannot remove the containerFolder (open files etc.)
Bugfix: Convert-ModifiedObjectsAsAl didn't include page extensions due to new parameter on Compare-NavApplicationObject
Bugfix: Use docker pull in New-NavContainer
Bugfix: New-NavContainer seems to hang
Add sync parameter on Publish-NavContainerApp
Added ExportTxtSkipUnlicensed to Export-NavContainerObjects
Add uninstall parameter on UnPublish-NavContainerApp
Add startup option to New-DesktopShortcut
Add generatesymbolreference=1 when Compiling objects using Compile-ObjectsInNavContainer
AzureSQL support for multitenancy
Add install parameter on Publish-NavContainerApp
Bugfix: Didn't work with "old" images
Bugfix: Create-AadAppsForNAV wasn't exported and was missing help
Check whether AAD is supported by Docker image
Add function Create-AadAppsForNav
Add parameter authenticationEmail to New-NavContainer
Remove default memory limit when running Windows Server as Docker host
Bugfix: Remove Test Tool shortcut when removing nav containers
Bugfix: Issue 89 CSide with external SQL and different port
Update Welcometext
Add support for multitenancy
Add switch -multitenant to new-navcontainer
Add function New-NavContainerTenant
Add function Remove-NavContainerTenant
Add function New-NavContainerNavUser
Add function New-NavContainerWindowsUser
Add function Get-NavContainerEventLog
Add function Export-NavContainerDatabasesAsBacpac
Change default filter in Compile-ObjectsInNavContainer to compiled=No
Add Shortcut for opening WebClient with Test Tool page if TestToolKit is included
Updated Readme
Add nav specific tags when running generic image
Check for tag tag when running fetching the tag (support generic image)
Check container name validity
Add test running generic image
Added switch for enabling SymbolLoading (dual development), default is off
Added function Import-TestToolkitToNavContainer
Added parameter -includeTestToolkit to New-NavContainer to automatically include TestToolkit objects
Include more information during start of new-navcontainer (and output the docker run command if it fails early)
Fix report preview when running docker images or earlier
Bugfix CSide desktop shortcut was always set to windows auth
Bugfix: Copying files to/from containers didn't work on Windows 10
Bugfix: Export-NavContainerObjects with a strange error if sharing the folder used for export directly
Export-NavContainerObjects now supports txt files and fob files -exportTo parameter replaces -exportToNewSyntax
Added Get-NavContainers to get all Nav containers
Add pipeline support for Remove-NavContainer and Remove-NavContainerSession (to allow Get-NavContainers | Remove-NavContainer)
Added Get-NavContainerDebugInfo
Show ContainerName in prompt in Enter-NavContainer
Bugfix: Do not clear modified flag when container is restarting
Bugfix: Azure VM detection looked in wrong folder
Bugfix: username can now contain spaces
-myscripts parameter now supports files or folders - all will be copied into the c:\run\my folder
Added -databaseServer, -databaseInstance, -databaseName, -databaseCredential to new-navcontainer (Support for External SQL Server - generic tag or later)
Added -shortcuts to new-navcontainer (support for placing shortcuts on startmenu or avoid them)
Added -navDvdPath and -navDvdCountry (support for running microsoft/dynamics-nav:generic with a DVD mounted)
Moved the working folder from c:\demo to c:\programdata\navcontainerhelper
Added -alwaysPull to new-navcontainerhelper to always pull newer image if exists
Remove recreate-navservercontainer
Simplify replace-navservercontainer and allow empty imagename
Breaking change: Change all username/password parameters to PSCredential
Change -updatehost to automatically update hosts on container restart
Breaking change: Remove -updatehost from Remove-NavContainer (automatically handled)
Add generatesymbolreference=yes to CSide shortcut if EnableSymbolLoading is true
When specifying -includeCSide containers are started with EnableSymbolLoad
Refactored all functions into different script files
Only clear object modified flag if using localhost\SQLExpress
Specify server in sqlcmd
Export-NavContainerObjects doesn't fail on NAV2016 and NAV2017 due to missing ExportToNewSyntax parameter
Added Start-NavContainerAppDataUpgrade function
Added ReleaseNotes a few versions back
Added ReleaseNotes to PowerShell Gallery
Added default values for additionalParameters and myScripts
Added -additionalParameters and -myScripts to New-CsideDevContainer and New-NavContainer
Added -useSSL switch to New-CsideDevContainer and New-NavContainer
Fixed a bug in Convert-ModifiedObjectsToAl, where conversion would end up with an empty AL folder
Secure passwords for creating containers and earlier
Initial releases
use help on the individual functions to get info.

Container info functions
Get-NavContainerNavVersion      Get Nav version from Nav Container
Get-NavContainerImageName       Get ImageName from Nav container
Get-NavContainerGenericTag      Get Nav generic image tag from Nav container
Get-NavContainerOsVersion       Get OS version from Nav container
Get-NavContainerLegal           Get Legal link from Nav container
Get-NavContainerCountry         Get Localization version from Nav Container
Get-NavContainerIpAddress       Get IP Address to a Nav container
Get-NavContainerSharedFolders   Get Shared Folders from a Nav container
Get-NavContainerPath            Get the path inside a Nav container to a shared file
Get-NavContainerName            Get the name of a Nav container
Get-NavContainerId              Get the Id of a Nav container
Test-NavContainer               Test whether a Nav container exists

Container handling functions
New-NavContainer                Create new Nav container
New-CSideDevContainer           Create new C/SIDE development container
Remove-NavContainer             Remove Nav container
Get-NavContainerSession         Create new session to a Nav container
Remove-NavContainerSession      Remove Nav container session
Enter-NavContainer              Enter Nav container session
Open-NavContainer               Open Nav container in new window
Wait-NavContainerReady          Wait for Nav Container to become ready

Object handling functions
Import-ObjectsToNavContainer    Import objects from .txt or .fob file
Import-DeltasToNavContainer     Merge delta files and Import objects
Compile-ObjectsInNavContainer   Compile objects
Export-NavContainerObjects      Export objects from Nav container
Create-MyOriginalFolder         Create folder with the original objects for modified objects
Create-MyDeltaFolder            Create folder with deltas for modified objects
Convert-Txt2Al                  Convert deltas folder to al folder
Export-ModifiedObjectsAsDeltas  Export objects, create baseline and create deltas
Convert-ModifiedObjectsToAl     Export objects, create baseline, create deltas and convert to .al files

App handling functions
Publish-NavContainerApp         Publish App to Nav container
Sync-NavContainerApp            Sync App in Nav container
Install-NavContainerApp         Install App in Nav container
Uninstall-NavContainerApp       Uninstall App from Nav container
Unpublish-NavContainerApp       Unpublish App from Nav container
Get-NavContainerAppInfo         Get info about installed apps from Nav Container
Install-NAVSipCryptoProviderFromNavContainer Install Nav Sip Crypto Provider locally from container to sign extensions

Azure VM specific functions
Replace-NavServerContainer      Replace navserver (primary) container
Recreate-NavServerContainer     Recreate navserver (primary) container

Version History

Version Downloads Last updated 1,564 8/18/2019 143 8/16/2019 367 8/15/2019 1,312 8/8/2019 1,647 8/2/2019 813 7/31/2019 662 7/28/2019 2,399 7/15/2019 1,649 7/6/2019 1,170 7/2/2019 754 6/27/2019 571 6/26/2019 163 6/25/2019 998 6/19/2019 1,029 6/16/2019 377 6/14/2019 276 6/13/2019 1,246 6/6/2019 2,357 5/24/2019 518 5/23/2019 4,216 5/3/2019 470 4/30/2019 544 4/27/2019 394 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 26 4/10/2019 3,488 3/27/2019 31 3/27/2019 1,385 3/19/2019 196 3/18/2019 2 3/18/2019 2,612 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,186 1/17/2019 167 1/17/2019 840 1/13/2019 4,258 12/11/2018 77 12/11/2018 179 12/10/2018 1,210 12/4/2018 639 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,167 10/23/2018 6,995 9/30/2018 2,195 9/22/2018 799 9/18/2018 701 9/16/2018 2,328 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,931 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 (current version) 732 3/22/2018 3 3/22/2018 300 3/19/2018 2,482 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,009 2/3/2018 8 2/3/2018 834 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 62 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 236 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