Business Central Programming - Beyond the Basics

If you don't have a Business Central Online subscription, you'll need to install an on-premises version of Business Central in order to follow the examples in the upcoming chapters.

Please note that the chapter titled "Admin Center Operations" applies exclusively to Business Central Online.

The PowerShell scripts that you need in this lesson are:

1. install-module bccontainerhelper

This command installs the BCContainerHelper module from the PowerShell Gallery. This module provides cmdlets for managing Microsoft Dynamics 365 Business Central containers.

2. Get-BcArtifactUrl -type onprem -country w1 -select All

This command retrieves the URL for the Business Central artifacts (like Docker images) for an on-premises deployment.

3. The third script uses the New-BCContainer cmdlet to create a new Business Central Docker container with the specified configuration, including memory limits and authentication settings.

Remember to enter the password, select an artifact URL, provide a container name, and optionally, change the user if desired.

$password = 'mypass'

$securePassword = ConvertTo-SecureString -String $password -AsPlainText -Force

$artifactUrl = "https://bcartifacts-exdbf9fwegejdqak.b02.azurefd.net/onprem/24.7.25890.0/w1"

$containerName = "bcserv"

$credential = New-Object pscredential 'admin', $securePassword

New-BCContainer -accept_eula `

                -accept_outdated `

                -updateHosts `

                -artifactUrl $artifactUrl `

                -containerName $containerName `

                -credential $credential `

                -auth UserPassword `

                -shortcuts StartMenu `

                -memoryLimit 8G `

                -alwaysPull

Note for On-Premises Business Central: To enable Application Insights, add the connection string to the app.json file in your Visual Studio project. You can find an example of this in the lesson Implementing Telemetry Using the LogMessage Function.