Stop-WebItem

Stop-WebItem

Stops an application pool or a site.

Syntax

Parameter Set: Default
Stop-WebItem [[-PSPath] <String[]> ] [-Passthru] [-Protocol <String> ] [ <CommonParameters>]

Detailed Description

TheStop-WebItemcmdlet is used to stop a Site or an application pool.

Parameters

-PSPath<String[]>

The path to the site or application pool.

Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Passthru

Passes an object that represents the Web item to the pipeline.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Protocol<String>

The protocol binding of the site to stop (sites only).

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • PSObject

Outputs

The output type is the type of the objects that the cmdlet emits.

  • PSObject

Examples

-------------- EXAMPLE 1: Stop a Web site --------------

Stops the site named Default Web Site. No output is returned.

IIS:\>Stop-WebItem 'IIS:\Sites\Default Web Site'

-------------- EXAMPLE 2: Stopping a Web site with feedback --------------

Stops the site named Default Web Site and reports whether the site was stopped.

Name ID State Physical Path Bindings

---- -- ----- ------------- --------

Default Web Site 1 Stopped C:\inetpub\wwwroot\Default Web http *:80:

Site

IIS:\>Stop-WebItem 'IIS:\Sites\Default Web Site' -Passthru

Get-WebItemState

Restart-WebItem

Start-WebItem