Remove-NAVServerInstance

Remove-NAVServerInstance

Removes a Microsoft Dynamics NAV Server instance.

Syntax

Parameter Set: __AllParameterSets
Remove-NAVServerInstance [-ServerInstance] <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

Use the Remove-NAVServerInstance cmdlet to remove a Microsoft Dynamics NAV Server instance. This cmdlet uninstalls an existing ServerInstance, including supporting directories, firewall exceptions, and supporting access control lists. The service is unregistered.

Parameters

-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

-ServerInstance<String>

Specifies the name of a Microsoft Dynamics NAV Server instance. The default instance name is DynamicsNAV90. You can specify either the full name of an instance (such as MicrosoftDynamicsNavServer$myinstance) or the short name (such as myinstance).

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, 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.

  • System.String

    You can pipe a string that contains a Microsoft Dynamics NAV Server instance name to the cmdlet.

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 removes the Microsoft Dynamics NAV Server instance myInstance.

C:\PS>Remove-NAVServerInstance myInstance -VERBOSE
VERBOSE: NavCommand.BeginProcessing

VERBOSE: NavCommand.ProcessRecord

VERBOSE: Performing operation "Remove-NAVServerInstance" on Target "ServerInstance = MicrosoftDynamicsNavServer$myInstance".

VERBOSE: Attempting to stop service MicrosoftDynamicsNavServer$myInstance

VERBOSE: Service MicrosoftDynamicsNavServer$myInstance is stopped

VERBOSE: Removing Windows Firewall Rule for ServerInstance MicrosoftDynamicsNavServer$myInstance

VERBOSE: Removing UrlAcl Rule for Server Instance MicrosoftDynamicsNavServer$myInstance

VERBOSE: Removing UrlAcl Rule for Server Instance MicrosoftDynamicsNavServer$myInstance

VERBOSE: Un-installing Server Instance MicrosoftDynamicsNavServer$myInstance 

VERBOSE: Removing Instance directory C:\Program Files\Microsoft Dynamics NAV\80\Service\Instances\myInstance

VERBOSE: NavCommand.EndProcessing