.png)
Remove-WebConfigurationLocation
Published: February 29, 2012
Updated: August 15, 2012
Applies To: Windows Server 2012
Remove-WebConfigurationLocation
Syntax
Parameter Set: Default Remove-WebConfigurationLocation [[-PSPath] <String[]> ] [[-Name] <String> ] [-Recurse] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
Removes an IIS configuration location.
Parameters
-Name<String>
The name of the configuration location that is to be removed.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
3 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByPropertyName) |
|
Accept Wildcard Characters? |
false |
-PSPath<String[]>
An IIS configuration path.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
2 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByPropertyName) |
|
Accept Wildcard Characters? |
false |
-Recurse
When theRecurseparameter is used, it specifies that locations within the hierarchy of the specified location are also removed.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
named |
|
Default Value |
none |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
|
Required? |
false |
|
Position? |
named |
|
Default Value |
false |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
|
Required? |
false |
|
Position? |
named |
|
Default Value |
false |
|
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.
Examples
-------------- EXAMPLE 1: Add and remove a configuration location --------------
This example adds, and then removes, a configuration location.
IIS:\>Set-WebConfigurationProperty -PSPath "IIS:\" -Filter //windowsAuthentication -Location "Default Web Site/mypage.htm" -Name enabled -Value true Get-WebConfigurationLocation -Name "Default Web Site" -PSPath "IIS:\" "Sleep 5 seconds before removing the configuration location"; Sleep 5 Remove-WebConfigurationLocation -Name "Default Web Site/my*" Get-WebConfigurationLocation -Name "Default Web Site" -PSPath "IIS:\"
