Rename-WebConfigurationLocation

Renames a configuration location.

Syntax

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

Description

Renames the specified configuration location with the new name provided.

Examples

-------------- EXAMPLE 1: Rename a configuration location --------------

IIS:\>Rename-WebConfigurationLocation -Name 'Default Web Site/oldApp' -NewName 'Default Web Site/newApp' -PSPath IIS:\

Renames a configuration location on the Default Web Site from "oldApp" to "newApp."

Required Parameters

-Name

The current name of the configuration location to rename.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-NewName

The new name of the configuration location to rename.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

An IIS configuration path to the location to rename.

Type:String[]
Position:1
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.

Type:SwitchParameter
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
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False