ContainerHandling/New-NavContainer.ps1
<#
.Synopsis Create or refresh a Nav container .Description Creates a new Nav container based on a Nav Docker Image Adds shortcut on the desktop for Web Client and Container PowerShell prompt .Parameter accept_eula Switch, which you need to specify if you accept the eula for running Nav on Docker containers (See https://go.microsoft.com/fwlink/?linkid=861843) .Parameter containerName Name of the new Nav container (if the container already exists it will be replaced) .Parameter imageName Name of the image you want to use for your Nav container (default is to grab the imagename from the navserver container) .Parameter navDvdPath When you are spinning up a Generic image, you need to specify the NAV DVD path .Parameter navDvdCountry When you are spinning up a Generic image, you need to specify the country version (w1, dk, etc.) .Parameter licenseFile Path or Secure Url of the licenseFile you want to use .Parameter credential Username and Password for the NAV Container .Parameter memoryLimit Memory limit for the container (default is unlimited for Windows Server host else 4G) .Parameter isolation Isolation mode for the container (default is process for Windows Server host else hyperv) .Parameter AuthenticationEmail AuthenticationEmail of the admin user of NAV .Parameter databaseServer Name of database server when using external SQL Server (omit if using database inside the container) .Parameter databaseInstance Name of database instance when using external SQL Server (omit if using database inside the container) .Parameter databaseName Name of database to connect to when using external SQL Server (omit if using database inside the container) .Parameter databaseCredential Credentials for the database connection when using external SQL Server (omit if using database inside the container) .Parameter shortcuts Location where the Shortcuts will be placed. Can be either None, Desktop or StartMenu .Parameter updateHosts Include this switch if you want to update the hosts file with the IP address of the container .Parameter useSSL Include this switch if you want to use SSL (https) with a self-signed certificate .Parameter includeCSide Include this switch if you want to have Windows Client and CSide development environment available on the host .Parameter enableSymbolLoading Include this switch if you want to do development in both CSide and VS Code to have symbols automatically generated for your changes in CSide .Parameter doNotExportObjectsToText Avoid exporting objects for baseline from the container (Saves time, but you will not be able to use the object handling functions without the baseline) .Parameter assignPremiumPlan Assign Premium plan to admin user .Parameter alwaysPull Always pull latest version of the docker image .Parameter useBestContainerOS Use the best Container OS based on the Host OS .Parameter multitenant Setup container for multitenancy by adding this switch .Parameter restart Define the restart option for the container .Parameter auth Set auth to Windows, NavUserPassword or AAD depending on which authentication mechanism your container should use .Parameter timeout Specify the number of seconds to wait for activity. Default is 1800 (30 min.). -1 means wait forever. .Parameter additionalParameters This allows you to transfer an additional number of parameters to the docker run .Parameter myscripts This allows you to specify a number of scripts you want to copy to the c:\run\my folder in the container (override functionality) .Parameter $TimeZoneId, This parameter specifies the timezone in which you want to start the Container. .Parameter $WebClientPort, Use this parameter to specify which port to use for the WebClient. Default is 80 if http and 443 if https. .Parameter $FileSharePort, Use this parameter to specify which port to use for the File Share. Default is 8080. .Parameter $ManagementServicesPort, Use this parameter to specify which port to use for Management Services. Default is 7045. .Parameter $ClientServicesPort, Use this parameter to specify which port to use for Client Services. Default is 7046. .Parameter $SoapServicesPort, Use this parameter to specify which port to use for Soap Web Services. Default is 7047. .Parameter $ODataServicesPort, Use this parameter to specify which port to use for OData Web Services. Default is 7048. .Parameter $DeveloperServicesPort, Use this parameter to specify which port to use for Developer Services. Default is 7049. .Parameter $PublishPorts, Use this parameter to specify the ports you want to publish on the host. Default is to NOT publish any ports. This parameter is necessary if you want to be able to connect to the container from outside the host. .Parameter $PublicDnsName Use this parameter to specify which public dns name is pointing to this container. This parameter is necessary if you want to be able to connect to the container from outside the host. .Example New-NavContainer -accept_eula -containerName test .Example New-NavContainer -accept_eula -containerName test -multitenant .Example New-NavContainer -accept_eula -containerName test -memoryLimit 3G -imageName "microsoft/dynamics-nav:2017" -updateHosts -useBestContainerOS .Example New-NavContainer -accept_eula -containerName test -imageName "microsoft/dynamics-nav:2017" -myScripts @("c:\temp\AdditionalSetup.ps1") -AdditionalParameters @("-v c:\hostfolder:c:\containerfolder") .Example New-NavContainer -accept_eula -containerName test -credential (get-credential -credential $env:USERNAME) -licenseFile "https://www.dropbox.com/s/fhwfwjfjwhff/license.flf?dl=1" -imageName "microsoft/dynamics-nav:devpreview-finus" #> function New-NavContainer { Param( [switch]$accept_eula, [switch]$accept_outdated, [Parameter(Mandatory=$true)] [string]$containerName, [string]$imageName = "", [string]$navDvdPath = "", [string]$navDvdCountry = "w1", [string]$licenseFile = "", [System.Management.Automation.PSCredential]$Credential = $null, [string]$authenticationEMail = "", [string]$memoryLimit = "", [ValidateSet('','process','hyperv')] [string]$isolation = "", [string]$databaseServer = "", [string]$databaseInstance = "", [string]$databaseName = "", [System.Management.Automation.PSCredential]$databaseCredential = $null, [ValidateSet('None','Desktop','StartMenu','CommonStartMenu')] [string]$shortcuts='Desktop', [switch]$updateHosts, [switch]$useSSL, [switch]$includeAL, [switch]$includeCSide, [switch]$enableSymbolLoading, [switch]$doNotExportObjectsToText, [switch]$alwaysPull, [switch]$useBestContainerOS, [switch]$assignPremiumPlan, [switch]$multitenant, [switch]$clickonce, [switch]$includeTestToolkit, [switch]$includeTestLibrariesOnly, [ValidateSet('no','on-failure','unless-stopped','always')] [string]$restart='unless-stopped', [ValidateSet('Windows','NavUserPassword','AAD')] [string]$auth='Windows', [int]$timeout = 1800, [string[]]$additionalParameters = @(), $myScripts = @(), [string]$TimeZoneId = $null, [int]$WebClientPort, [int]$FileSharePort, [int]$ManagementServicesPort, [int]$ClientServicesPort, [int]$SoapServicesPort, [int]$ODataServicesPort, [int]$DeveloperServicesPort, [int[]]$PublishPorts = @(), [string]$PublicDnsName ) if (!$accept_eula) { throw "You have to accept the eula (See https://go.microsoft.com/fwlink/?linkid=861843) by specifying the -accept_eula switch to the function" } Check-NavContainerName -ContainerName $containerName if ($Credential -eq $null -or $credential -eq [System.Management.Automation.PSCredential]::Empty) { if ($auth -eq "Windows") { $credential = get-credential -UserName $env:USERNAME -Message "Using Windows Authentication. Please enter your Windows credentials." } else { $credential = get-credential -Message "Using NavUserPassword Authentication. Please enter username/password for the Containter." } if ($Credential -eq $null -or $credential -eq [System.Management.Automation.PSCredential]::Empty) { throw "You have to specify credentials for your Container" } } if ($auth -eq "Windows") { if ($credential.Username.Contains('@')) { throw "You cannot use a Microsoft account, you need to use a local Windows user account (like $env:USERNAME)" } if ($credential.Username.Contains('\')) { throw "The username cannot contain domain information, you need to use a local Windows user account (like $env:USERNAME)" } } $myScripts | ForEach-Object { if ($_ -is [string]) { if ($_.StartsWith("https://", "OrdinalIgnoreCase") -or $_.StartsWith("http://", "OrdinalIgnoreCase")) { } elseif (!(Test-Path $_)) { throw "Script directory or file $_ does not exist" } } elseif ($_ -isnot [Hashtable]) { throw "Illegal value in myScripts" } } $os = (Get-CimInstance Win32_OperatingSystem) if ($os.OSType -ne 18 -or !$os.Version.StartsWith("10.0.")) { throw "Unknown Host Operating System" } $UBR = (Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name UBR).UBR $hostOsVersion = [System.Version]::Parse("$($os.Version).$UBR") $hostOs = "Unknown/Insider build" $bestContainerOs = "ltsc2016" $bestGenericContainerOs = "ltsc2016" if ($os.BuildNumber -ge 17763) { if ($os.BuildNumber -eq 17763) { $hostOs = "ltsc2019" } $bestContainerOs = "ltsc2019" $bestGenericContainerOs = "ltsc2019" } elseif ($os.BuildNumber -ge 17134) { if ($os.BuildNumber -eq 17134) { $hostOs = "1803" } $bestGenericContainerOs = "1803" } elseif ($os.BuildNumber -ge 16299) { if ($os.BuildNumber -eq 16299) { $hostOs = "1709" } $bestGenericContainerOs = "1709" } elseif ($os.BuildNumber -eq 15063) { $hostOs = "1703" } elseif ($os.BuildNumber -ge 14393) { $hostOs = "ltsc2016" } $navContainerHelperVersion = $MyInvocation.MyCommand.Module.Version Write-Host "NavContainerHelper is version $navContainerHelperVersion" $isServerHost = $os.ProductType -eq 3 Write-Host "Host is $($os.Caption) - $hostOs" $dockerService = (Get-Service docker -ErrorAction Ignore) if (!($dockerService)) { throw "Docker Service not found. Docker is not started, not installed or not running Windows Containers." } if ($dockerService.Status -ne "Running") { throw "Docker Service is $($dockerService.Status) (Needs to be running)" } $dockerOS = docker version -f "{{.Server.Os}}" if ($dockerOS -ne "Windows") { throw "Docker is running $dockerOS containers, you need to switch to Windows containers." } $dockerClientVersion = (docker version -f "{{.Client.Version}}") Write-Host "Docker Client Version is $dockerClientVersion" $dockerServerVersion = (docker version -f "{{.Server.Version}}") Write-Host "Docker Server Version is $dockerClientVersion" $parameters = @() $devCountry = "" $navVersion = "" if ($imageName -eq "") { $alwaysPull = $true if ("$navDvdPath" -ne "") { $imageName = "microsoft/dynamics-nav:generic" } elseif (Test-NavContainer -containerName navserver) { $imageName = Get-NavContainerImageName -containerName navserver } else { $imageName = "microsoft/dynamics-nav:latest" } } if (!$imageName.Contains(':')) { $imageName += ":latest" } # Determine best container ImageName (append -ltsc2016 or -ltsc2019) $bestImageName = Get-BestNavContainerImageName -imageName $imageName if ($useBestContainerOS) { $imageName = $bestImageName } if (!($alwaysPull)) { $imageExists = $false $bestImageExists = $false docker images --format "{{.Repository}}:{{.Tag}}" | ForEach-Object { if ("$_" -eq "$imageName" -or "$_" -eq "$($imageName):latest") { $imageExists = $true } if ("$_" -eq "$bestImageName") { $bestImageExists = $true } } if ($bestImageExists) { $imageName = $bestImageName } elseif ($imageExists) { Write-Host "NOTE: Add -alwaysPull or -useBestContainerOS if you want to use $bestImageName instead of $imageName." } else { $alwaysPull = $true } } if ($alwaysPull) { try { Write-Host "Pulling image $bestImageName" DockerDo -command pull -imageName $bestImageName | Out-Null $imageName = $bestImageName } catch { if ($imageName -eq $bestImageName) { throw } Write-Host "Pulling image $imageName" DockerDo -command pull -imageName $imageName | Out-Null } } Write-Host "Using image $imageName" if ($multitenant) { $parameters += "--env multitenant=Y" } if ($clickonce) { $parameters += "--env clickonce=Y" } if ($WebClientPort) { $parameters += "--env WebClientPort=$WebClientPort" } if ($FileSharePort) { $parameters += "--env FileSharePort=$FileSharePort" } if ($ManagementServicesPort) { $parameters += "--env ManagementServicesPort=$ManagementServicesPort" } if ($ClientServicesPort) { $parameters += "--env ClientServicesPort=$ClientServicesPort" } if ($SoapServicesPort) { $parameters += "--env SoapServicesPort=$SoapServicesPort" } if ($ODataServicesPort) { $parameters += "--env ODataServicesPort=$ODataServicesPort" } if ($DeveloperServicesPort) { $parameters += "--env DeveloperServicesPort=$DeveloperServicesPort" } $publishPorts | ForEach-Object { Write-Host "Publishing port $_" $parameters += "--publish $($_):$($_)" } if ($publicDnsName) { Write-Host "PublicDnsName is $publicDnsName" $parameters += "--env PublicDnsName=$PublicDnsName" } # Remove if it already exists Remove-NavContainer $containerName $containerFolder = Join-Path $ExtensionsFolder $containerName Remove-Item -Path $containerFolder -Force -Recurse -ErrorAction Ignore New-Item -Path $containerFolder -ItemType Directory -ErrorAction Ignore | Out-Null if ($navDvdPath.EndsWith(".zip", [StringComparison]::OrdinalIgnoreCase)) { $temp = Join-Path $containerFolder "NAVDVD" new-item -type directory -Path $temp | Out-Null if ($navDvdPath.StartsWith("http://", [StringComparison]::OrdinalIgnoreCase) -or $navDvdPath.StartsWith("https://", [StringComparison]::OrdinalIgnoreCase)) { Write-Host "Downloading DVD .zip file from $navdvdpath" Download-File -sourceUrl $navDvdPath -destinationFile "$temp.zip" Write-Host "Extracting DVD .zip file" Expand-Archive -Path "$temp.zip" -DestinationPath $temp Remove-Item -Path "$temp.zip" } else { Write-Host "Extracting DVD .zip file" Expand-Archive -Path $navDvdPath -DestinationPath $temp } $navDvdPath = $temp } if ("$navDvdPath" -ne "") { $navversion = (Get-Item -Path "$navDvdPath\ServiceTier\program files\Microsoft Dynamics NAV\*\Service\Microsoft.Dynamics.Nav.Server.exe").VersionInfo.FileVersion $devCountry = $navDvdCountry $navtag = Get-NavVersionFromVersionInfo -VersionInfo $navversion $parameters += @( "--label nav=$navtag", "--label version=$navversion", "--label country=$devCountry", "--label cu=" ) $navVersion += "-$devCountry" } elseif ($devCountry -eq "") { $devCountry = Get-NavContainerCountry -containerOrImageName $imageName } Write-Host "Creating Nav container $containerName" if ("$licenseFile" -ne "") { Write-Host "Using license file $licenseFile" } if ($navVersion -eq "") { $navversion = Get-NavContainerNavversion -containerOrImageName $imageName } Write-Host "Version: $navversion" $version = [System.Version]($navversion.split('-')[0]) $platformversion = Get-NavContainerPlatformversion -containerOrImageName $imageName -ErrorAction SilentlyContinue if ($platformversion) { Write-Host "Platform: $platformversion" } $genericTag = Get-NavContainerGenericTag -containerOrImageName $imageName Write-Host "Generic Tag: $genericTag" $containerOsVersion = [Version](Get-NavContainerOsVersion -containerOrImageName $imageName) if ("$containerOsVersion".StartsWith('10.0.14393.')) { $containerOs = "ltsc2016" if (!$useBestContainerOS -and $TimeZoneId -eq $null) { $timeZoneId = (Get-TimeZone).Id } } elseif ("$containerOsVersion".StartsWith('10.0.15063.')) { $containerOs = "1703" } elseif ("$containerOsVersion".StartsWith('10.0.16299.')) { $containerOs = "1709" } elseif ("$containerOsVersion".StartsWith('10.0.17134.')) { $containerOs = "1803" } elseif ("$containerOsVersion".StartsWith('10.0.17763.')) { $containerOs = "ltsc2019" } else { $containerOs = "unknown" } Write-Host "Container OS Version: $containerOsVersion ($containerOs)" Write-Host "Host OS Version: $hostOsVersion ($hostOs)" if (($hostOsVersion.Major -lt $containerOsversion.Major) -or ($hostOsVersion.Major -eq $containerOsversion.Major -and $hostOsVersion.Minor -lt $containerOsversion.Minor) -or ($hostOsVersion.Major -eq $containerOsversion.Major -and $hostOsVersion.Minor -eq $containerOsversion.Minor -and $hostOsVersion.Build -lt $containerOsversion.Build)) { throw "The container operating system is newer than the host operating system." } elseif ($hostOsVersion.Major -ne $containerOsversion.Major -or $hostOsVersion.Minor -ne $containerOsversion.Minor -or $hostOsVersion.Build -ne $containerOsversion.Build) { if ("$NavDvdPath" -eq "" -and $useBestContainerOS -and "$containerOs" -ne "$bestGenericContainerOs") { # There is a generic image, which is better than the selected image Write-Host "A better Generic Container OS exists for your host ($bestGenericContainerOs)" # Extract files from image if not already done $NavDvdPath = Join-Path $containerHelperFolder "$($NavVersion)-Files" if (!(Test-Path $NavDvdPath)) { Extract-FilesFromNavContainerImage -imageName $imageName -path $navDvdPath } $inspect = docker inspect $imageName | ConvertFrom-Json $parameters += @( "--label nav=$($inspect.Config.Labels.nav)", "--label version=$($inspect.Config.Labels.version)", "--label country=$($inspect.Config.Labels.country)", "--label cu=$($inspect.Config.Labels.cu)" ) $imageName = "microsoft/dynamics-nav:generic-$bestGenericContainerOs" DockerDo -command pull -imageName $imageName | Out-Null if ("$hostOs" -ne "$bestGenericContainerOs") { Write-Host "The best generic container operating system does not match the host operating system, forcing hyperv isolation." $isolation = "hyperv" } } elseif ($isolation -ne "hyperv") { Write-Host "The container operating system does not match the host operating system, forcing hyperv isolation." $isolation = "hyperv" } } $locale = Get-LocaleFromCountry $devCountry if ((!$doNotExportObjectsToText) -and ($version -lt [System.Version]"8.0.0.0")) { throw "PowerShell Cmdlets to export objects as text are not included before NAV 2015, please specify -doNotExportObjectsToText." } if ($multitenant -and ($version -lt [System.Version]"7.1.0.0")) { throw "Multitenancy is not supported in NAV 2013" } if ($includeAL -and ($version.Major -lt 14)) { throw "IncludeAL is supported from Dynamics 365 Business Central Spring 2019 release (1904 / 14.x)" } if ($multitenant -and [System.Version]$genericTag -lt [System.Version]"0.0.4.5") { throw "Multitenancy is not supported by images with generic tag prior to 0.0.4.5" } if (($WebClientPort -or $FileSharePort -or $ManagementServicesPort -or $ClientServicesPort -or $SoapServicesPort -or $ODataServicesPort -or $DeveloperServicesPort) -and [System.Version]$genericTag -lt [System.Version]"0.0.6.5") { throw "Changing endpoint ports is not supported by images with generic tag prior to 0.0.6.5" } if ($auth -eq "AAD" -and [System.Version]$genericTag -lt [System.Version]"0.0.5.0") { throw "AAD authentication is not supported by images with generic tag prior to 0.0.5.0" } if ("$isolation" -eq "") { if ($isServerHost) { $isolation = "process" } else { $isolation = "hyperv" if ($dockerClientVersion.StartsWith("master-dockerproject-") -and ($dockerClientVersion -gt "master-dockerproject-2018-12-01")) { $isolation = "process" } else { [System.Version]$ver = $null if ([System.Version]::TryParse($dockerClientVersion.Split('-')[0],[ref]$ver)) { if ($ver -gt [System.Version]::new(18,9,0)) { $isolation = "process" } } } } } Write-Host "Using $isolation isolation" $myFolder = Join-Path $containerFolder "my" New-Item -Path $myFolder -ItemType Directory -ErrorAction Ignore | Out-Null $myScripts | ForEach-Object { if ($_ -is [string]) { if ($_.StartsWith("https://", "OrdinalIgnoreCase") -or $_.StartsWith("http://", "OrdinalIgnoreCase")) { $uri = [System.Uri]::new($_) $filename = [System.Uri]::UnescapeDataString($uri.Segments[$uri.Segments.Count-1]) $destinationFile = Join-Path $myFolder $filename Download-File -sourceUrl $_ -destinationFile $destinationFile if ($destinationFile.EndsWith(".zip", "OrdinalIgnoreCase")) { Write-Host "Extracting .zip file" Expand-Archive -Path $destinationFile -DestinationPath $myFolder Remove-Item -Path $destinationFile -Force } } elseif (Test-Path $_ -PathType Container) { Copy-Item -Path "$_\*" -Destination $myFolder -Recurse -Force } else { if ($_.EndsWith(".zip", "OrdinalIgnoreCase")) { Expand-Archive -Path $_ -DestinationPath $myFolder } else { Copy-Item -Path $_ -Destination $myFolder -Force } } } else { $hashtable = $_ $hashtable.Keys | ForEach-Object { Set-Content -Path (Join-Path $myFolder $_) -Value $hashtable[$_] } } } if ("$licensefile" -eq "") { if ($includeCSide -and !$doNotExportObjectsToText) { throw "You must specify a license file when creating a CSide Development container or use -doNotExportObjectsToText to avoid baseline generation." } if ($includeAL) { throw "You must specify a license file when creating a AL Development container." } $containerlicenseFile = "" } elseif ($licensefile.StartsWith("https://", "OrdinalIgnoreCase") -or $licensefile.StartsWith("http://", "OrdinalIgnoreCase")) { $licensefileUri = $licensefile $licenseFile = "$myFolder\license.flf" Download-File -sourceUrl $licenseFileUri -destinationFile $licenseFile $bytes = [System.IO.File]::ReadAllBytes($licenseFile) $text = [System.Text.Encoding]::ASCII.GetString($bytes, 0, 100) if (!($text.StartsWith("Microsoft Software License Information"))) { Remove-Item -Path $licenseFile -Force throw "Specified license file Uri isn't a direct download Uri" } $containerLicenseFile = "c:\run\my\license.flf" } else { Copy-Item -Path $licenseFile -Destination "$myFolder\license.flf" -Force $containerLicenseFile = "c:\run\my\license.flf" } $parameters += @( "--name $containerName", "--hostname $containerName", "--env auth=$auth" "--env username=""$($credential.UserName)""", "--env ExitOnError=N", "--env locale=$locale", "--env licenseFile=""$containerLicenseFile""", "--env databaseServer=""$databaseServer""", "--env databaseInstance=""$databaseInstance""", "--volume ""$($hostHelperFolder):$containerHelperFolder""", "--volume ""$($myFolder):C:\Run\my""", "--isolation $isolation", "--restart $restart" ) if ("$memoryLimit" -eq "") { if ($isolation -eq "hyperv") { $parameters += "--memory 4G" } } else { $parameters += "--memory $memoryLimit" } if ($version.Major -gt 11) { $parameters += "--env enableApiServices=Y" } if ("$databaseName" -ne "") { $parameters += "--env databaseName=""$databaseName""" } if ("$authenticationEMail" -ne "") { $parameters += "--env authenticationEMail=""$authenticationEMail""" } if ($enableSymbolLoading -and $version.Major -ge 11) { $parameters += "--env enableSymbolLoading=Y" } else { $enableSymbolLoading = $false } if ($includeCSide) { $programFilesFolder = Join-Path $containerFolder "Program Files" New-Item -Path $programFilesFolder -ItemType Directory -ErrorAction Ignore | Out-Null # Clear modified flag on all objects (' if ($restartingInstance -eq $false -and $databaseServer -eq "localhost" -and $databaseInstance -eq "SQLEXPRESS") { sqlcmd -S ''localhost\SQLEXPRESS'' -d $DatabaseName -Q "update [dbo].[Object] SET [Modified] = 0" | Out-Null } ') | Add-Content -Path "$myfolder\AdditionalSetup.ps1" if (Test-Path $programFilesFolder) { Remove-Item $programFilesFolder -Force -Recurse -ErrorAction Ignore } New-Item $programFilesFolder -ItemType Directory -ErrorAction Ignore | Out-Null (' if ($restartingInstance -eq $false) { Copy-Item -Path "C:\Program Files (x86)\Microsoft Dynamics NAV\*" -Destination "c:\navpfiles" -Recurse -Force -ErrorAction Ignore $destFolder = (Get-Item "c:\navpfiles\*\RoleTailored Client").FullName $ClientUserSettingsFileName = "$runPath\ClientUserSettings.config" [xml]$ClientUserSettings = Get-Content $clientUserSettingsFileName $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""Server""]").value = "$publicDnsName" $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""ServerInstance""]").value="NAV" if ($multitenant) { $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""TenantId""]").value="$TenantId" } if ($clientUserSettings.SelectSingleNode("//appSettings/add[@key=""ServicesCertificateValidationEnabled""]") -ne $null) { $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""ServicesCertificateValidationEnabled""]").value="false" } if ($clientUserSettings.SelectSingleNode("//appSettings/add[@key=""ClientServicesCertificateValidationEnabled""]") -ne $null) { $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""ClientServicesCertificateValidationEnabled""]").value="false" } $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""ClientServicesPort""]").value="$publicWinClientPort" $acsUri = "$federationLoginEndpoint" if ($acsUri -ne "") { if (!($acsUri.ToLowerInvariant().Contains("%26wreply="))) { $acsUri += "%26wreply=$publicWebBaseUrl" } } $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""ACSUri""]").value = "$acsUri" $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""DnsIdentity""]").value = "$dnsIdentity" $clientUserSettings.SelectSingleNode("//configuration/appSettings/add[@key=""ClientServicesCredentialType""]").value = "$Auth" $clientUserSettings.Save("$destFolder\ClientUserSettings.config") } ') | Add-Content -Path "$myfolder\AdditionalSetup.ps1" } if ($assignPremiumPlan) { if (!(Test-Path -Path "$myfolder\SetupNavUsers.ps1")) { ('# Invoke default behavior . (Join-Path $runPath $MyInvocation.MyCommand.Name) ') | Set-Content -Path "$myfolder\SetupNavUsers.ps1" } (' Get-NavServerUser -serverInstance NAV -tenant default |? LicenseType -eq "FullUser" | ForEach-Object { $UserId = $_.UserSecurityId Write-Host "Assign Premium plan for $($_.Username)" $dbName = $DatabaseName if ($multitenant) { $dbName = $TenantId } sqlcmd -S ''localhost\SQLEXPRESS'' -d $DbName -Q "INSERT INTO [dbo].[User Plan] ([Plan ID],[User Security ID]) VALUES (''{8e9002c0-a1d8-4465-b952-817d2948e6e2}'',''$userId'')" | Out-Null } ') | Add-Content -Path "$myfolder\SetupNavUsers.ps1" } Write-Host "Creating container $containerName from image $imageName" if ($useSSL) { $parameters += "--env useSSL=Y" } else { $parameters += "--env useSSL=N" } if ($includeCSide) { $parameters += "--volume ""$($programFilesFolder):C:\navpfiles""" } if ("$navDvdPath" -ne "") { $parameters += "--volume ""$($navDvdPath):c:\NAVDVD""" } if ($updateHosts) { $parameters += "--volume ""c:\windows\system32\drivers\etc:C:\driversetc""" Copy-Item -Path (Join-Path $PSScriptRoot "updatehosts.ps1") -Destination $myfolder -Force (' . (Join-Path $PSScriptRoot "updatehosts.ps1") -hostsFile "c:\driversetc\hosts" -hostname '+$containername+' -ipAddress $ip ') | Add-Content -Path "$myfolder\AdditionalOutput.ps1" } if ([System.Version]$genericTag -ge [System.Version]"0.0.3.0") { $passwordKeyFile = "$myfolder\aes.key" $passwordKey = New-Object Byte[] 16 [Security.Cryptography.RNGCryptoServiceProvider]::Create().GetBytes($passwordKey) $containerPasswordKeyFile = "c:\run\my\aes.key" try { Set-Content -Path $passwordKeyFile -Value $passwordKey $encPassword = ConvertFrom-SecureString -SecureString $credential.Password -Key $passwordKey $parameters += @( "--env securePassword=$encPassword", "--env passwordKeyFile=""$containerPasswordKeyFile""", "--env removePasswordKeyFile=Y" ) if ($databaseCredential -ne $null -and $databaseCredential -ne [System.Management.Automation.PSCredential]::Empty) { $encDatabasePassword = ConvertFrom-SecureString -SecureString $databaseCredential.Password -Key $passwordKey $parameters += @( "--env databaseUsername=$($databaseCredential.UserName)", "--env databaseSecurePassword=$encDatabasePassword" "--env encryptionSecurePassword=$encDatabasePassword" ) } $parameters += $additionalParameters if (!(DockerDo -accept_eula -accept_outdated:$accept_outdated -detach -imageName $imageName -parameters $parameters)) { return } Wait-NavContainerReady $containerName -timeout $timeout } finally { Remove-Item -Path $passwordKeyFile -Force -ErrorAction Ignore } } else { $plainPassword = ([System.Runtime.InteropServices.Marshal]::PtrToStringAuto([System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($credential.Password))) $parameters += "--env password=""$plainPassword""" $parameters += $additionalParameters if (!(DockerDo -accept_eula -accept_outdated:$accept_outdated -detach -imageName $imageName -parameters $parameters)) { return } Wait-NavContainerReady $containerName -timeout $timeout } if ("$TimeZoneId" -ne "") { Write-Host "Set TimeZone in Container to $TimeZoneId" Invoke-ScriptInNavContainer -containerName $containerName -scriptblock { Param($TimeZoneId) $OldTimeZoneId = (Get-TimeZone).Id try { if ($OldTimeZoneId -ne $TimeZoneId) { Set-TimeZone -ID $TimeZoneId } } catch { Write-Host "WARNING: Unable to set TimeZone to $TimeZoneId, TimeZone is $OldTimeZoneId" } } -argumentList $TimeZoneId } Write-Host "Reading CustomSettings.config from $containerName" $customConfig = Get-NavContainerServerConfiguration -ContainerName $containerName if ($enableSymbolLoading) { # Unpublish symbols when running hybrid development Invoke-ScriptInNavContainer -containerName $containerName -scriptblock { # Unpublish only, when Apps when present Get-NavAppInfo -ServerInstance NAV -Name "Application" -Publisher "Microsoft" -SymbolsOnly | Unpublish-NavApp Get-NavAppInfo -ServerInstance NAV -Name "Test" -Publisher "Microsoft" -SymbolsOnly | Unpublish-NavApp } } if ($shortcuts -ne "None") { Write-Host "Creating Desktop Shortcuts for $containerName" if (-not [string]::IsNullOrEmpty($customConfig.PublicWebBaseUrl)) { $webClientUrl = $customConfig.PublicWebBaseUrl if ($multitenant) { $webClientUrl += "?tenant=default" } New-DesktopShortcut -Name "$containerName Web Client" -TargetPath "$webClientUrl" -IconLocation "C:\Program Files\Internet Explorer\iexplore.exe, 3" -Shortcuts $shortcuts if ($includeTestToolkit) { if ($webClientUrl.Contains('?')) { $webClientUrl += "&page=130401" } else { $webClientUrl += "?page=130401" } New-DesktopShortcut -Name "$containerName Test Tool" -TargetPath "$webClientUrl" -IconLocation "C:\Program Files\Internet Explorer\iexplore.exe, 3" -Shortcuts $shortcuts } } $dockerIco = Join-Path $PSScriptRoot "docker.ico" New-DesktopShortcut -Name "$containerName Command Prompt" -TargetPath "CMD.EXE" -IconLocation $dockerIco -Arguments "/C docker.exe exec -it $containerName cmd" -Shortcuts $shortcuts New-DesktopShortcut -Name "$containerName PowerShell Prompt" -TargetPath "CMD.EXE" -IconLocation $dockerIco -Arguments "/C docker.exe exec -it $containerName powershell -noexit c:\run\prompt.ps1" -Shortcuts $shortcuts } if ([System.Version]$genericTag -lt [System.Version]"0.0.4.4") { if (Test-Path -Path "C:\windows\System32\t2embed.dll" -PathType Leaf) { Copy-FileToNavContainer -containerName $containerName -localPath "C:\windows\System32\t2embed.dll" -containerPath "C:\Windows\System32\t2embed.dll" } } if ($auth -eq "AAD" -and [System.Version]$genericTag -le [System.Version]"0.0.9.2") { Write-Host "Using AAD authentication, Microsoft.IdentityModel.dll is missing, download and copy" $wifdll = Join-Path $containerFolder "Microsoft.IdentityModel.dll" Download-File -sourceUrl 'https://bcdocker.blob.core.windows.net/public/Microsoft.IdentityModel.dll' -destinationFile $wifdll $ps = 'Join-Path (Get-Item ''C:\Program Files\Microsoft Dynamics NAV\*\Service'').FullName "Microsoft.IdentityModel.dll"' $containerWifDll = docker exec $containerName powershell $ps Copy-FileToNavContainer -containerName $containerName -localPath $wifdll -containerPath $containerWifDll } $sqlCredential = $databaseCredential if ($sqlCredential -eq $null -and $auth -eq "NavUserPassword") { $sqlCredential = New-Object System.Management.Automation.PSCredential ('sa', $credential.Password) } if ($includeTestToolkit) { Import-TestToolkitToNavContainer -containerName $containerName -sqlCredential $sqlCredential -includeTestLibrariesOnly:$includeTestLibrariesOnly } if ($includeCSide) { $winClientFolder = (Get-Item "$programFilesFolder\*\RoleTailored Client").FullName New-DesktopShortcut -Name "$containerName Windows Client" -TargetPath "$WinClientFolder\Microsoft.Dynamics.Nav.Client.exe" -Arguments "-settings:ClientUserSettings.config" -Shortcuts $shortcuts New-DesktopShortcut -Name "$containerName WinClient Debugger" -TargetPath "$WinClientFolder\Microsoft.Dynamics.Nav.Client.exe" -Arguments "-settings:ClientUserSettings.config ""DynamicsNAV:////debug""" -Shortcuts $shortcuts $databaseInstance = $customConfig.DatabaseInstance $databaseName = $customConfig.DatabaseName $databaseServer = $customConfig.DatabaseServer if ($databaseServer -eq "localhost") { $databaseServer = "$containerName" } if ($auth -eq "Windows") { $ntauth="1" } else { $ntauth="0" } if ($databaseInstance) { $databaseServer += "\$databaseInstance" } $csideParameters = "servername=$databaseServer, Database=$databaseName, ntauthentication=$ntauth, ID=$containerName" if ($enableSymbolLoading) { $csideParameters += ",generatesymbolreference=1" } New-DesktopShortcut -Name "$containerName CSIDE" -TargetPath "$WinClientFolder\finsql.exe" -Arguments "$csideParameters" -Shortcuts $shortcuts } if (($includeCSide -and !$doNotExportObjectsToText) -or $includeAL) { # Include oldsyntax only if IncludeCSide is specified # Include newsyntax if NAV Version is greater than NAV 2017 if ($includeCSide) { $originalFolder = Join-Path $ExtensionsFolder "Original-$navversion" if (!(Test-Path $originalFolder)) { # Export base objects Export-NavContainerObjects -containerName $containerName ` -objectsFolder $originalFolder ` -filter "" ` -sqlCredential $sqlCredential ` -ExportTo 'txt folder' } } if ($version.Major -gt 10) { $originalFolder = Join-Path $ExtensionsFolder "Original-$navversion-newsyntax" if (!(Test-Path $originalFolder)) { # Export base objects as new syntax Export-NavContainerObjects -containerName $containerName ` -objectsFolder $originalFolder ` -filter "" ` -sqlCredential $sqlCredential ` -ExportTo 'txt folder (new syntax)' } if ($version.Major -ge 14 -and $includeAL) { $alFolder = Join-Path $ExtensionsFolder "Original-$navversion-al" if (!(Test-Path $alFolder)) { $dotNetAddInsPackage = Join-Path $ExtensionsFolder "$containerName\coredotnetaddins.al" Copy-Item -Path (Join-Path $PSScriptRoot "..\ObjectHandling\coredotnetaddins.al") -Destination $dotNetAddInsPackage -Force Convert-Txt2Al -containerName $containerName -myDeltaFolder $originalFolder -myAlFolder $alFolder -startId 50100 -dotNetAddInsPackage $dotNetAddInsPackage } } } } if ($includeAL) { $dotnetAssembliesFolder = Join-Path $containerFolder ".netPackages" New-Item -Path $dotnetAssembliesFolder -ItemType Directory -ErrorAction Ignore | Out-Null Write-Host "Creating .net Assembly Reference Folder for VS Code" Invoke-ScriptInNavContainer -containerName $containerName -scriptblock { Param($dotnetAssembliesFolder) "C:\Windows\assembly", (Get-Item "C:\Program Files\Microsoft Dynamics NAV\*\Service").FullName, (Get-Item "C:\Program Files (x86)\Microsoft Dynamics NAV\*\RoleTailored Client").FullName, "C:\Program Files (x86)\Open XML SDK" | % { Copy-Item -Path $_ -Destination $dotnetAssembliesFolder -Force -Recurse -Filter "*.dll" } } -argumentList $dotnetAssembliesFolder } Write-Host -ForegroundColor Green "Nav container $containerName successfully created" } Export-ModuleMember -function New-NavContainer |