Share via

Remove-NAVServerInstance

  • Reference
Module:
Microsoft.BusinessCentral.Management

Removes a Business Central Server instance.

Syntax

Remove-NAVServerInstance
      [-ServerInstance] <String>
      [-Force]
      [-ProgressAction <ActionPreference>]
      [-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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProgressAction

A common PowerShell parameter that determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider. Learn more.

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

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

Outputs

None