Edit

Remove-WebConfigurationLocation

  • Reference
Module:
WebAdministration

Removes an IIS configuration location.

Syntax

Remove-WebConfigurationLocation
      [[-Name] <String>]
      [-Recurse]
      [[-PSPath] <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-WebConfigurationLocation cmdlet removes an Internet Information Services (IIS) configuration location.

Examples

Example 1: Add and remove a configuration location

IIS:\> Set-WebConfigurationProperty -PSPath "IIS:\" -Filter "//windowsAuthentication" -Location "Default Web Site/mypage.htm" -Name "enabled" -Value $True 
IIS:\> Get-WebConfigurationLocation -Name "Default Web Site" -PSPath "IIS:\" "Sleep 5 seconds before removing the configuration location"; Sleep 5 
IIS:\> Remove-WebConfigurationLocation -Name "Default Web Site/my*" 
IIS:\> Get-WebConfigurationLocation -Name "Default Web Site" -PSPath "IIS:\"

This example adds, and then removes, a configuration location.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-Name

Specifies the name of the configuration location that this cmdlet removes.

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

-PSPath

Specifies an IIS configuration path.

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

-Recurse

Indicates that this cmdlet removes locations within the hierarchy of the specified location.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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