PowerShell Studio: Rename Refactoring

• Windows PowerShell

User Rating: 3 / 5

Rename refactoring allows you to intelligently rename variables, controls, parameters, functions and more.

You start by right-clicking on the object you wish to rename to bring up the context menu. Then select Rename… from the menu:

You are then presented with the rename dialog:

Let us cover each field:

New Name:

Here you enter the new name for the selected object.

Object Type:

This field lets you know what type of object you are renaming.

The field will display the following types:

Note: Depending on the object’s type the some settings may vary.

Scope:

The scope lets you define in which scope the objects will be replaced.

Depending on the object type the following scopes may be selected:

GUI Controls, Events, Parameters and Functions will always apply to the global scope such as the Current Document or the Entire Project.

Preview references changes:

When this option is checked, you will be presented with a dialog listing all the changes that will take affect.

Here you can preview the changes by clicking on any item in the list.

You can also uncheck an item if you do not want that particular instance to be modified.

Note: You are unable to uncheck items if you are renaming a GUI Control.

Rename Refactoring in Projects

Rename refactoring can be extremely useful when dealing with multiple files as in a project, because it will update all the project files (with the exception of excluded files):

In PowerShell Studio return variables are updated when a GUI control is renamed. In addition, when you rename a project file in PowerShell Studio, all the reference functions and return variables are updated to reflect the new file name.

 If you include ps1 files as content and dot source the file within a project, calls to functions defined in the dot sourced file can be updated using rename refactoring.

The rename refactoring feature can be a big time saver when renaming events, variables, functions and other objects. In addition, with the preview you can quickly see where the object is used and selectively decide if you want to go forward with any change.

• Prev
• Next