Remove-PnPWeb

Removes a subweb in the current web

Syntax

Remove-PnPWeb
      -Url <String>
                   [-Force [<SwitchParameter>]]
                   [-Web <WebPipeBind>]
                   [-Connection <SPOnlineConnection>]
Remove-PnPWeb
      -Identity <WebPipeBind>
                   [-Force [<SwitchParameter>]]
                   [-Web <WebPipeBind>]
                   [-Connection <SPOnlineConnection>]

Examples

------------------EXAMPLE 1------------------

Remove-PnPWeb -Url projectA

Remove a web

------------------EXAMPLE 2------------------

Remove-PnPWeb -Identity 5fecaf67-6b9e-4691-a0ff-518fc9839aa0

Remove a web specified by its ID

------------------EXAMPLE 3------------------

Get-PnPSubWebs | Remove-PnPWeb -Force

Remove all subwebs and do not ask for confirmation

Parameters

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Force

Do not ask for confirmation to delete the subweb

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Identity

Identity/Id/Web object to delete

Type:WebPipeBind
Position:Named
Accept pipeline input:True
Accept wildcard characters:False
-Url

The site relative url of the web, e.g. 'Subweb1'

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Web

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Type:WebPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False