How to: Install Control Add-Ins and Support Files for Your Solution

  • Article

If the Microsoft Dynamics NAV application that you are deploying on Microsoft Azure includes control add-ins or additional files that will run on the Microsoft Dynamics NAV Server, then you must first install these files to the Azure virtual machine. To accomplish this, you customize the HowTo-UploadFilesToVM.ps1 script that is available with the Microsoft Dynamics NAV Provisioning Tools for Microsoft Azure. If you are using the example end-to-end scripts Example-1VM and Example-2VM to deploy Microsoft Dynamics NAV, perform the following procedure before you run the scripts.

To install control add-ins to the Azure virtual machine

  1. Place the control add-in assembly (.dll) or support files on your provisioning computer.

  2. Open the HowTo-UploadFilesToVM.ps1 script for editing.

    The script is located in the Cloud\NAVRemoteAdministration folder of the Microsoft Dynamics NAV Provisioning Tools for Microsoft Azure.

  3. Locate the following command:

    # Copy-FileToRemoteMachine -SourceFile 'C:\MyAddin.dll' -DestinationFile 'C:\Program Files\Microsoft Dynamics NAV\80\Service\Add-ins\MyAddin\MyAddin.dll' -Session $psSession

  4. Do the following:

    1. Remove the comment character #.

    2. Change the value of C:\MyAddin.dll to the path and name of the control add-in or support file that you want to deploy on the Azure virtual machine.

    3. Change the value of MyAddin\MyAddin.dll to the folder and name of the control add-in on the Azure virtual machine.

      Note

      The C:\Program Files\Microsoft Dynamics NAV\80\Service\Add-ins\ folder is the default folder for control add-ins on the virtual machine that is running Microsoft Dynamics NAV Server.

    4. Add the command for each additional file that you want to upload.

  5. Save the HowTo-UploadFilesToVM.ps1 script.

See Also

Concepts

Deploying Microsoft Dynamics NAV Using the Example Scripts
Deploying and Managing Microsoft Dynamics NAV on Microsoft Azure

Other Resources

Preparing for Deploying Microsoft Dynamics NAV on Microsoft Azure
Extending Microsoft Dynamics NAV Using Control Add-ins