New-NAVWebServerInstance
New-NAVWebServerInstance
Creates a new Microsoft Dynamics NAV Web Server instance and binds this instance to a Microsoft Dynamics NAV Server instance.
Syntax
Parameter Set: Default
New-NAVWebServerInstance [-WebServerInstance] <String> -Server <String> -ServerInstance <String> [-AcsUri <String> ] [-ClientServicesCredentialType <NavClientCredentialType> ] [-ClientServicesPort <ServicePort> ] [-Company <String> ] [-DnsIdentity <String> ] [-Force] [-Language <String> ] [-RegionFormat <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed 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 2013 R2 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.
Parameters
-AcsUri<String>
Specifies the Uniform Resource Identifier (URI) of Windows Azure Access Control Service (ACS) or Windows Azure Active Directory (AAD) that is used for authenticating Microsoft Dynamics NAV users.
This parameter is only relevant when the ClientServicesCredentialType parameter is set to AccessControlService. With AccessControlService, users are authenticated by using either Windows Azure Access Control Service (ACS) or Windows Azure Active Directory (AAD).
When using ACS authentication, the ACSUri parameter specifies the URI of the ACS login page for relying party applications. An example of a URI is https://CRONUSInternationalLtd.accesscontrol.windows.net/v2/wsfederation?wa=wsignin1.0%26wtrealm=https%3a%2f%2flocalhost%2f. For more information, see For more information about ACS, see How to: Configure the Microsoft Dynamics NAV Web Client for ACS in the Microsoft Dynamics NAV Developer and IT Pro Help in the MSDN Library.
When using AAD authentication, the ACSUri specifies the URI of the AAD authentication page, which is specific to an AAD tenant for signing on users. An example of a URI is https://login.windows.net/\[Tenant\_ID\]/wsfed?wa=wsignin1.0%26wtrealm=https%3a%2f%2flocalhost%2f. [Tenant_ID] specifies the AAD tenant. For more information, see Authenticate Users with Windows Azure Active Directory in the Microsoft Dynamics NAV Developer and IT Pro Help in the MSDN Library.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ClientServicesCredentialType<NavClientCredentialType>
The type of client credential used for client authentication.
Possible values are: Windows, UserName, NavUserPassword, or AccessControlService.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
Windows |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ClientServicesPort<ServicePort>
Specifies the port that is used to communicate with the client services of the Microsoft Dynamics NAV Server instance.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Company<String>
Specifies the name of the Microsoft Dynamics NAV company to connect to.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DnsIdentity<String>
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.
Aliases |
none |
Required? |
false |
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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Language<String>
Sets the language version of the Microsoft Dynamics NAV Web client. The value must be a valid culture name for a language in Microsoft Dynamics NAV, such as en-US or da-DK.
The culture name has the format: nn-NN. nn is a lowercase two-letter code for the language and NN is an uppercase two-letter code for the country or region. For example, en-US is for English (United States) and en-GB is for English (United Kingdom), and da-DK is for Danish (Denmark). There are some languages that use a three-letter language code or a suffix to the region code. The culture name must follow the RFC 1766 standard. For a list of the most common culture names, see https://go.microsoft.com/fwlink/?LinkID=255174.
For the Spanish version of Microsoft Dynamics NAV, you must set the value to es-ES_tradnl.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RegionFormat<String>
Specifies the culture name that is used to format dates, times, numbers, and currency in the Microsoft Dynamics NAV Web client.
A language culture name that has the format: nn-NN. nn is a lowercase two-letter code for the language and NN is an uppercase two-letter code for the country or region. For example, en-US is for English (United States), en-GB is for English (United Kingdom), and da-DK is for Danish (Denmark). There are some languages that use a three-letter language code or a suffix to the region code. The culture name must follow the RFC 1766 standard. For a list of the most common culture names, see https://go.microsoft.com/fwlink/?LinkID=255174.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Server<String>
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.
Aliases |
ComputerName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ServerInstance<String>
The name of the instance of Microsoft Dynamics NAV Server that this instance of Microsoft Dynamics NAV Web Server connects to.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-WebServerInstance<String>
The name of the web server instance. This will be used as the name of the IIS web application.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
None
This cmdlet does not accept any input.
Outputs
The output type is the type of the objects that the cmdlet emits.
None
This cmdlet does not generate any output.
Examples
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
This example creates a new Microsoft Dynamics NAV Server instance that is named MyNavApp. The Microsoft Dynamics NAV Server instance connects to the DynamicsNAV71 server instance on the MyNavServer computer. By default, the Microsoft Dynamics NAV Server instance is configured to use Windows authentication to authenticate users.
PS C:\> New-NAVWebServerInstance MyNavApp –Server MyNavServer –ServerInstance DynamicsNAV71 –Company MyNavCompany