Remove-NAVWebServerInstance

Removes an existing Business Central web server instance.

Syntax

Remove-NAVWebServerInstance
      [-WebServerInstance] <String>
      [[-SiteDeploymentType] <String>]
      [[-ContainerSiteName] <String>]
      [-RemoveContainer]
      [-ProgressAction <ActionPreference>]
      [<CommonParameters>]

Description

The Business Central Web, Phone, and Tablet clients use a Business Central Web Server instance on IIS. Use the Remove-NAVWebServerInstance cmdlet to delete a specific web server instance. The cmdlet deletes all subfolders, web applications, and components that are associated with the web server instance.

Examples

EXAMPLE 1

Remove-NAVWebServerInstance -WebServerInstance BC -SiteDeploymentType RootSite

This example removes a root-level web server instance.

EXAMPLE 2

Remove-NAVWebServerInstance -WebServerInstance BC

This example removes a web server instance that was created as a SubSite type.

Parameters

-ContainerSiteName

Specifies the name of the container website that the SubSite-type web server instance belongs to. This setting is only used if SiteDeploymentType has been set to 'SubSite'. If the subsite is under the default container website 'Business Central [Version] Web Client' then you can omit this parameter.

Type:String
Position:3
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

-RemoveContainer

Specifies to remove the container website that the SubSite web server instance belongs to. This will remove all folders and subsites (web applications) of the container website.

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

-SiteDeploymentType

Specifies the deployment type of web server instance. There are two possible values: SubSite and RootSite.

  • Use SubSite if the web server instance was created as a sub-site (web application) to a container website. If you specify SubSite, you will have to set the -ContainerSiteName parameter. If the subsite is under the default container website 'Business Central [Version] Web Client' then you can omit this parameter.
  • Use RootSite if the web server instance was created as a root-level website. If you use this value, all folders and subsites of the instance will be removed.
Type:String
Position:2
Default value:SubSite
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WebServerInstance

Specifies the name of the web server instance in IIS that you want to remove.

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