New-NAVWebServerInstance

Creates a new Microsoft Dynamics NAV Web Server instance and binds this instance to a Microsoft Dynamics NAV Server instance.

Syntax

New-NAVWebServerInstance
   [-WebServerInstance] <String>
   [-Server] <String>
   [-ServerInstance] <String>
   [[-ClientServicesCredentialType] <String>]
   [[-ClientServicesPort] <Int32>]
   [[-SiteDeploymentType] <String>]
   [[-ContainerSiteName] <String>]
   [[-WebSitePort] <Int32>]
   [[-AppPoolName] <String>]
   [[-PublishFolder] <String>]
   [[-DnsIdentity] <String>]
   [[-CertificateThumbprint] <String>]
   [-AddFirewallException]
   [[-HelpServer] <String>]
   [[-HelpServerPort] <Int32>]
   [<CommonParameters>]

Description

Use the New-NAVWebServerInstance cmdlet to create a new Microsoft Dynamics NAV Web Server instance for the Microsoft Dynamics NAV Web client and bind this instance to a Microsoft Dynamics NAV Server instance on the same computer or on a remote computer. In IIS, a new virtual directory and application for the instance is added to the existing Microsoft Dynamics NAV 2016 Web Client website.

If you call this cmdlet multiple times then multiple instances are created. For more information, see How to: Set Up Multiple Web Server Instances for the Microsoft Dynamics NAV Web Client in the Microsoft Dynamics NAV Developer and IT Pro Help in the MSDN Library.

Examples

EXAMPLE 1

New-NAVWebServerInstance MyNavApp -Server MyNavServer -ServerInstance DynamicsNAV -Company MyNavCompany

This example creates a new Microsoft Dynamics NAV Web Server instance that is named MyNavApp. The Microsoft Dynamics NAV Server instance connects to the DynamicsNAV server instance on the MyNavServer computer. By default, the Microsoft Dynamics NAV Server instance is configured to use Windows authentication to authenticate users.

Parameters

-AddFirewallException

Specifies whether to allow inbound communication on the TCP port that is specified by the -WebSitePort parameter. If you use this parameter, an inbound rule for the port will be added to Windows Firewall.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppPoolName

Specifies the application pool that the web server instance will use. If you do not specify an application pool, the default Dynamics NAV Web Client application pool will be used.

Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

Specifies the thumbprint of the security certificate to use to configure an HTTPS binding for the web server instance. The certificate must be installed in the local computer certificate store.

Type:String
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientServicesCredentialType

The type of client credential used for client authentication. Possible values are: Windows, UserName, NavUserPassword, or AccessControlService.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientServicesPort

Specifies the port that is used to communicate with the client services of the Microsoft Dynamics NAV Server instance.

Type:Int32
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerSiteName

Specifies the name the container website to which you want to add the web server instance. This setting is only used if the -SiteDeploymentType parameter is set to ‘SubSite’. If you specify a container name that does not exist, a new site with is created as a container for the new web server instance. The website has no content but has binding on the port that specify with the -WebSitePort parameter.

Type:String
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsIdentity

Identifies a certificate in the local certificate store that must be used when signing in to Microsoft Dynamics NAV Server.

One of the initial checks when a client authenticates a server is to compare the value of the Subject field of the certificate to the URI that is used to contact the service. The DNS of both must match. For example, if the URI of the service is "net.tcp://NavServer.com:7046/DynamicsNav/Service" then the Subject field of the certificate must also contain the value "NavServer.com".

Typically, the Subject is prefixed with "CN" (for common name), for example, "CN = NavServer.com", but it can also just be "NavServer.com". It is also possible for the Subject field to be blank, in which case the validation rules will be applied to the Subject Alternative Name field of the certificate.

The DnsIdentity configuration settings can be used to associate an endpoint with the specified Dns name. The DnsIdentity configuration settings can be used to associate an endpoint with the specified Dns name.

Type:String
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HelpServer

Specifies the name of computer that hosts the Dynamics NAV Help Server that provides online help to Dynamics NAV Web client users.

Type:String
Position:13
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HelpServerPort

Specifies the TCP port (such as 49000) that is used by the Dynamics NAV Help Server on the computer specified by the -HelpServer parameter.

Type:Int32
Position:14
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishFolder

Specifies the location of the WebPublish folder that contains the content file that is required for Dynamics NAV Web client. If you omit this parameter, the cmdlet will look for the folder path '%systemroot%\Program Files\Microsoft Dynamics NAV[version number]\Web Client\WebPublish'

Type:String
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Server

The name of the computer on which Microsoft Dynamics NAV Server is installed. This parameter accepts "localhost" if the Microsoft Dynamics NAV Server instance and the Microsoft Dynamics NAV Web Server instance are installed on the same computer.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerInstance

The name of the instance of Microsoft Dynamics NAV Server that this instance of Microsoft Dynamics NAV Web Server connects to.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SiteDeploymentType

Specifies how the web server instance is installed IIS regarding its hierarchical structure and relationships. There are two possible values: RootSite and SubSite.

  • RootSite a adds the web server instance as root-level website in IIS that has its own bindings. The URL for the web server has the format: http://WebserverComputerName:port/.
  • SubSite adds the web server instance as an application under an existing or new container website, which you specify with the -ContainerSiteName parameter. If you are adding the SubSite instance to a new container website, you will also have to set the -WebSitePort parameter to setup the binding. You can add multiple SubSites to a container website. The SubSites inherit the binding defined on the container website.

If you omit this parameter, a subsite instance will be added to the default container website called 'Microsoft Dynamics NAV [Version] Web Client". If this contianer website does not exist, it will be added.

Type:String
Position:6
Default value:SubSite
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WebServerInstance

The name of the web server instance. This will be used as the name of the IIS web application.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WebSitePort

Specifies the TCP port number under which the web server instance will be running. This is the port will be used to access the Dynamics NAV Web client and will be part of the URL. This parameter is only used if the -SiteDeploymentType parameter is set to ‘RootSite’ or set to ‘SubSite’ if you are creating a new container website.

Type:Int32
Position:8
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

You can pipe a string that contains a Microsoft Dynamics NAV Web Server instance name to the cmdlet.

Outputs

None