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 <String> ] [-ClientServicesPort <Int> ] [-Company <String> ] [-DnsIdentity <String> ] [ <CommonParameters>]
Detailed Description
Use the New-NAVWebServerInstance cmdlet to create a new Microsoft Dynamics NAV Web Server instance and bind this instance to a Microsoft Dynamics NAV Server instance on the same computer or on a remote computer.
If you call this cmdlet multiple times then multiple instances of the Microsoft Dynamics NAV Web Server are created. Each instance of the Microsoft Dynamics NAV Web Server is created as an IIS web application under a generic Microsoft Dynamics NAV Web Server website.
Parameters
-AcsUri<String>
Specifies the Uniform Resource Identifier (URI) of Windows Azure Access Control Service (ACS) that is used for authenticating Microsoft Dynamics NAV users.
This parameter is only relevant when the ClientServicesCredentialType parameter is set to AccessControlService. For more information about ACS, see Use ACS to Authenticate Users in the Microsoft Dynamics NAV 2013 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<String>
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<Int>
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 |
7046 |
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 |
-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 |
none |
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 |
<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 Web Server instance that is named MyNavApp. The Microsoft Dynamics NAV Web Server instance connects to the DynamicsNAV70 server instance on the MyNavServer computer. By default, the Microsoft Dynamics NAV Web Server instance is configured to use Windows authentication to authenticate users.
PS C:\> New-NAVWebServerInstance MyNavApp –Server MyNavServer –ServerInstance DynamicsNAV70 –Company MyNavCompany