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
   [-ClientServicesCredentialType <NavClientCredentialType>]
   [-ClientServicesPort <ServicePort>]
   [-RegionFormat <LanguageSetting>]
   [-Language <LanguageSetting>]
   [-Company <String>]
   [-DnsIdentity <String>]
   -Server <String>
   -ServerInstance <String>
   [-WebServerInstance] <String>
   [-AcsUri <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<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.

Required Parameters

-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
Aliases:ComputerName
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
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:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
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
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-AcsUri

This parameter is no longer used. It was deprecated in Microsoft Dynamics NAV 2017. It has been replaced by the WSFederationLoginEndpoint key in the Microsoft Dynamics NAV Server configuration file, which you can set by using the Set-NAVServerConfiguration cmdlet.

Position:Named
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:NavClientCredentialType
Parameter Sets:None, Windows, UserName, NavUserPassword, AccessControlService, ExchangeIdentity, TaskScheduler
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
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:ServicePort
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Company

This parameter is deprecated. The company setting is now stored in a system table per user. Users can the company by by using the My Settings page in the client. Administrators can globally change the company by using User Personalization pages in the client. If unspecified it is auto-assigned on first session based on companies to which the user has permissions.

Position:Named
Accept pipeline input:false
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Language

This parameter is deprecated. The language setting is now stored in a system table per user. Users can the language by by using the My Settings page in the client. Administrators can globally change the language by using User Personalization pages in the client. If the language is unspecified, it is auto-assigned on first session based on browser\device settings, which is subject to an explicit fallback algorithm depending on local build (for example, en-GB falls back to en-CA on CA builds).

Position:Named
Accept pipeline input:false
Accept wildcard characters:False
-RegionFormat

This parameter is deprecated. The region format is now stored in a system table per user. Users can change the region format by using the My Settings page in the client. Administrators can globally change the region format by using User Personalization pages in the client. If the region format is unspecified, it is auto-assigned on first session based on browser\device settings.

Position:Named
Accept pipeline input:false
Accept wildcard characters:False
-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
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