Share via

Remove-NAVWebServerInstance

Module:
Microsoft.Dynamics.Nav.Management Module

Removes an existing Microsoft Dynamics NAV Web Server instance.

Syntax

Default (Default) 

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.

Parameter properties

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

Parameter sets

(All)
Position:3
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:False
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

-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.

Parameter properties

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

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

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

Parameter sets

(All)
Position:1
Mandatory:True
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 Microsoft Dynamics NAV Web Server instance name to the cmdlet.

Outputs

None