Remove-NAVWebServerInstance

  • Reference
Module:
Microsoft.Dynamics.Nav.Management

Removes an existing Microsoft Dynamics NAV Web Server instance.

Syntax

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

Description

The Remove-NAVWebServerInstance cmdlet deletes all virtual folders, web applications, and physical folders on IIS for a Microsoft Dynamics NAV Web Server instance that was created by the New-NAVWebServerInstance cmdlet.

Examples

EXAMPLE 1

Remove-NAVWebServerInstance -WebServerInstance MyNavApp

This example removes the Microsoft Dynamics NAV Server instance that is named MyNavApp.

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 'Microsoft Dynamics NAV [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

-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 'Microsoft Dynamics NAV [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 Microsoft Dynamics NAV Web Server instance to delete. This is the name that is used by the web application on IIS and is specified as the virtual directory alias for the Microsoft Dynamics NAV Web Server instance.

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

Inputs

System.String

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

Outputs

None