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