New-NAVServerInstance

New-NAVServerInstance

Use the New-NAVServerSettings cmdlet to create a new Microsoft Dynamics NAV server instance. The settings are based on default values.

Parameter Set: __AllParameterSets
New-NAVServerInstance [-ServerInstance] <String> -ClientServicesPort <ServicePort> -ManagementServicesPort <ServicePort> -ODataServicesPort <ServicePort> -SOAPServicesPort <ServicePort> [-Domain <String> ] [-Password <String> ] [-ServiceAccount <ServiceAccount> ] [-UserName <String> ] [ <CommonParameters>]

This cmdlet creates a new server instance and sets up all the permissions that are required for the server instance to start. The configuration values for the new server instance are based on default values so you must specify the database server and database name before the server can accept client requests.

-Domain<String>

The domain for the service account security context.

false

named

false

false

-Password<String>

The password for the service account security context.

false

named

false

false

-ServerInstance<String>

The name that identifies the service that this instance references. The default instance name is MicrosoftDynamicsNavServer.
If a server instance other than the default instance is specified, either the full name such as 'MicrosoftDynamicsNavServer$MyInstance' or the short name such as 'MyInstance' can be specified.
Note: Remember to delimit the instance name with single-quotes.

true

1

true (ByValue, ByPropertyName)

false

-ServiceAccount<ServiceAccount>

The service account that the server instance uses. Accepts values from the System.ServiceProcess.ServiceAccount enumeration.
Only network service and user values are supported.

false

named

false

false

-UserName<String>

The user name for the service account security context.

false

named

false

false

-ClientServicesPort<ServicePort>

true

named

false

false

-ManagementServicesPort<ServicePort>

true

named

false

false

-ODataServicesPort<ServicePort>

true

named

false

false

-SOAPServicesPort<ServicePort>

true

named

false

false

<CommonParameters>

  • System.String

    You can pipe a string that contains the server instance name to the cmdlet.

  • None

    This cmdlet does not generate any output.

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

This example creates a new NAV server instance, makes the necessary firewall exceptions and UrlAcl registrations.

C:\PS>New-NAVServerInstance NewNAVServer -ManagementServicePort 8099 -ServerPort 8100 -WebServicePort 8101 -DataServicePort 8102 -verboseVERBOSE: NavCommand.BeginProcessingVERBOSE: NavCommand.ProcessRecordVERBOSE: Evaluating Pre-Requisites: System.Collections.Generic.List`1[Microsoft.Dynamics.Nav.Management.Requisite]VERBOSE: Creating Instance directory C:\Program Files (x86)\Microsoft Dynamics NAV\60\Service\Instances\NewNAVServerVERBOSE: Installing Server Instance MicrosoftDynamicsNavServer$NewNAVServerVERBOSE: Adding Windows Firewall Rule for Server Instance MicrosoftDynamicsNavServer$NewNAVServerVERBOSE: Adding Windows Firewall Rule for Server Instance MicrosoftDynamicsNavServer$NewNAVServerVERBOSE: Adding Windows Firewall Rule for Server Instance MicrosoftDynamicsNavServer$NewNAVServerVERBOSE: Adding UrlAcl Rule for Server Instance MicrosoftDynamicsNavServer$NewNAVServerVERBOSE: Adding UrlAcl Rule for Server Instance MicrosoftDynamicsNavServer$NewNAVServerVERBOSE: NavCommand.EndProcessing