Share via

Remove-NAVServerInstance

Module:
Microsoft.Dynamics.Nav.Management Module

Removes a Business Central Server instance.

Syntax

Default (Default) 

Remove-NAVServerInstance
    [-ServerInstance] <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Examples

EXAMPLE 1

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\Business Central\130\Service\Instances\myInstance

VERBOSE: NavCommand.EndProcessing

This example removes the Business Central Server instance myInstance.

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ServerInstance

Specifies the name of a Business Central Server instance, for example, BC or myinstance. You can specify either the full name of an instance, such as MicrosoftDynamicsNavServer$myinstance or the short name such as myinstance.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

System.String

You can pipe a string that contains a Business Central Server instance name to the cmdlet.

Outputs

None