Skip to content

Latest commit

 

History

History
130 lines (98 loc) · 3.2 KB

Remove-WebConfigurationLocation.md

File metadata and controls

130 lines (98 loc) · 3.2 KB
description external help file Module Name ms.date online version schema title
Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
Microsoft.IIS.PowerShell.Provider.dll-Help.xml
WebAdministration
12/27/2016
2.0.0
Remove-WebConfigurationLocation

Remove-WebConfigurationLocation

SYNOPSIS

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
Parameter Sets: (All)
Aliases: cf

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

-Name

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

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PSPath

Specifies an IIS configuration path.

Type: String[]
Parameter Sets: (All)
Aliases: 

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Recurse

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-WhatIf

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

Get-WebConfigurationLocation

Rename-WebConfigurationLocation