.png)
Rename-WebConfigurationLocation
Published: February 29, 2012
Updated: August 15, 2012
Applies To: Windows Server 2012
Rename-WebConfigurationLocation
Syntax
Parameter Set: Default Rename-WebConfigurationLocation [[-PSPath] <String[]> ] -Name <String> -NewName <String> [-Recurse] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
Renames the specified configuration location with the new name provided.
Parameters
-Name<String>
The current name of the configuration location to rename.
|
Aliases |
none |
|
Required? |
true |
|
Position? |
named |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByPropertyName) |
|
Accept Wildcard Characters? |
false |
-NewName<String>
The new name of the configuration location to rename.
|
Aliases |
none |
|
Required? |
true |
|
Position? |
named |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByPropertyName) |
|
Accept Wildcard Characters? |
false |
-PSPath<String[]>
An IIS configuration path to the location to rename.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
2 |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByPropertyName) |
|
Accept Wildcard Characters? |
false |
-Recurse
If included, specifies that location tags defined lower in the location hierarchy should also be renamed.
|
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: Rename a configuration location --------------
Renames a configuration location on the Default Web Site from "oldApp" to "newApp."
IIS:\>Rename-WebConfigurationLocation -Name 'Default Web Site/oldApp' -NewName 'Default Web Site/newApp' -PSPath IIS:\
