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