Share via

How to Add a Microsoft Dynamics NAV Web Server Instance

  • Article

This topic describes how to use the Dynamics NAV Administration Shell to add a Dynamics NAV web server instance on a computer or virtual machine. The Microsoft Dynamics NAV Administration Shell includes the New-NAVWebServerInstance cmdlet that creates an application on IIS for the Microsoft Dynamics NAV Web client.

To add a Dynamics NAV web server instance

  1. On the computer or virtual machine that is running Microsoft Dynamics NAV Server, run Dynamics NAV Administration Shell as an Administrator.

    1. Choose Start, in the Search box, type Dynamics NAV Administration Shell.

    2. Right-click the related link, and then choose Run as Administrator.

  2. At the command prompt, type the following command:

    New-NAVWebServerInstance -WebServerInstance <MyWebApp> -Server <NAVServer> -ServerInstance <NAVServerInstance> -ClientServicesCredentialType <NAVCredentialType>

    Change the following parameter values.

    Parameter Description
    <MyWebApp> Specifies the name that you want to give the Microsoft Dynamics NAV Web client application instance. This name will become part of the URL for the Microsoft Dynamics NAV Web client application, for example, https://MyWebServer:8080/MyWebApp or https://MyWebServer:8080/MyWebApp/WebClient (for Microsoft Dynamics NAV 2017 and earlier versions).
    <NAVServer> Specifies the name of the computer that is running the Microsoft Dynamics NAV Server to connect the Dynamics NAV web server to.
    <NAVServerInstance> Specifies the name of the Microsoft Dynamics NAV Server instance to connect the web server instance to.
    <NAVCredentialType> Specifies the credential type that is configured for the Microsoft Dynamics NAV Web client and Microsoft Dynamics NAV Server. Valid options are NavUserPassword, Windows, UserName, and AccessControlService. The default value is NavUserPassword. Important: The credential type must match the credential type that is used by the Dynamics NAV web server to authenticate Microsoft Dynamics NAV Web client users. For more information, see Configuring the Credential Type on the Microsoft Dynamics NAV Web Client Web Site.

    Note

    The command that is shown includes only the required parameters of the NAVWebServerInstance cmdlet. The cmdlet has several other parameters that can be used to configure the web server instance. For more information about the syntax and parameters, see New-NAVWebServerInstance cmdlet topic in the Administration Cmdlets for Dynamics NAV section of the Technical Reference.

  3. Press Enter to run the cmdlet.

    A new Dynamics NAV web server instance with the specified name is added to the Microsoft Dynamics NAV Web client site on IIS.

    Note

    If you want to change the configuration of the new Dynamics NAV web server instance after it has been added, modify the configuration file. For more information, see Configuring Microsoft Dynamics NAV Web Client by Modifying the Web.config File.

Example

This example creates a new Dynamics NAV web server instance that is named MyNavApp. The Dynamics NAV web server instance connects to the DynamicsNAV110 server instance on the MyNavServer computer.

New-NAVWebServerInstance -WebServerInstance MyNavApp –Server MyNavServer –ServerInstance nav_server_instance –Company MyNavCompany -ClientServicesCredentialType NavUserPassword

To open the Microsoft Dynamics NAV Web client for this example, open the following URL in a web browser:

https://mymachine.cloudapp.net/MyNavApp

See Also

Scaling the Microsoft Dynamics NAV Network Topology
Deploying the Microsoft Dynamics NAV Web Server Components
How to: Set Up Multiple Web Server Instances for the Microsoft Dynamics NAV Web Client
Deploying and Managing Microsoft Dynamics NAV on Microsoft Azure
How to: Add a Microsoft Dynamics NAV Server Instance
How to: Add a Microsoft Dynamics NAV Database
How to: Add a Microsoft Dynamics NAV Company