Alias Provider

This command changes the current location to the Alias: drive. You can use this command from any drive in Windows PowerShell. To return to a file system drive, type the drive name. For example, type "set-location c:".

set-location alias:

This command gets a list of all the aliases in the current session. You can use this command in any Windows PowerShell drive.

get-item -path alias:

This command gets the "ls" alias. Because it includes the path, you can use it in any Windows PowerShell drive.

get-item -path alias:ls

If you are in the Alias: drive, you can omit the drive name from the path.

This command gets a list of the aliases that are associated with the Get-ChildItem cmdlet. It uses the Definition property, which stores the cmdlet name.

get-item -path alias:* | where-object {$_.Definition -eq "Get-Childitem"}

When the aliased item is an executable file, the Definition contains the fully qualified path of the file.

This command gets the list of all the aliases when the current location is the Alias: drive. It uses a wildcard character (*) to indicate all the contents of the current location.

get-item -path *

In the Alias: drive, a dot (.), which represents the current location, and a wildcard character (*), which represents all items in the current location, have the same effect. For example, "get-item -path ." or "get-item *" produce the same result.

This command creates the "serv" alias for the Get-Service cmdlet. Because the current location is in the Alias: drive, the value of the Path parameter is a dot (.). The dot represents the current location.

This command also uses the Options dynamic parameter to set the AllScope and Constant options on the alias. The Options parameter is available in the New-Item cmdlet only when you are in the Alias: drive.

new-item -path . -name serv -value Get-Service -Options "AllScope,Constant"

If you are in the Alias: drive, you can omit the drive name from the path.

You can create an alias for any item that invokes a command. This command creates the "np" alias for Notepad.exe.

new-item -path alias:np -value c:\windows\notepad.exe

You can create an alias for any function. You can use this feature to create an alias that includes both a cmdlet and its parameters.

The first command creates the CD32 function, which changes the current directory to the System32 directory. The second command creates the "go" alias for the CD32 function. The semi-colon (;) is the command separator.

When the command is complete, you can use either "CD32" or "go" to invoke the function.

function CD32 {set-location -path c:\windows\system32} set-item -path alias:go -value CD32

This command uses the Get-Item cmdlet to get all aliases. The pipeline operator (|) sends the results to the Get-Member cmdlet, which displays the methods and properties of the object.

get-item -path alias:* | get-member

When you pipe a collection of objects to Get-Member, such as the collection of aliases in the Alias: drive, Get-Member evaluates each object in the collection separately. Then, Get-Member returns information about each object type that it finds. If all the objects are of the same type, it returns information about the single object type. In this case, all the aliases are AliasInfo objects. To get information about the collection of AliasInfo objects, use the InputObject parameter of Get-Member. For example, use the following command: Get-Member -InputObject (Get-Item alias:*) When you use InputObject, Get-Member evaluates the collection, not the objects in the collection.

This command lists the values of the properties of the "dir" alias. It uses the Get-Item cmdlet to get an object that represents the "dir" alias. The pipeline operator (|) sends the results to the Format-List command. The Format-List command uses the Property parameter with a wildcard character (*) to format and display the values of all the "dir" alias properties.

get-item alias:dir | format-list -property *

You can use the Set-Item cmdlet with the Options dynamic parameter to change the value of the Options property of an alias.

This command sets the AllScope and ReadOnly options for the "dir" alias. The command uses the Options dynamic parameter of the Set-Item cmdlet. The Options parameter is available in Set-Item only when you use it with the Alias or Function provider.

set-item -path alias:dir -options "AllScope,ReadOnly"

This command uses the Set-Item cmdlet to change the "gp" alias so that it represents the Get-Process cmdlet instead of the Get-ItemProperty cmdlet. The Force parameter is required because the value of the Options property of the "gp" alias is set to ReadOnly. Because the command is submitted from within the Alias: drive, the drive is not specified in the path.

set-item -path gp -value get-process -force

The change affects the four properties that define the association between the alias and the command. To view the effect of the change, type the following command: get-item -path gp | format-list -property *

This command uses the Rename-Item cmdlet to change the "popd" alias to "pop".

rename-item -path alias:popd -newname pop

This command copies the pushd alias so that a new push alias is created for the Push-Location cmdlet.

copy-item -path alias:pushd -destination alias:push

When the new alias is created, its Description property has a null value. And, its Option property has a value of None. If the command is issued from within the Alias: drive, you can omit the drive name from the value of the Path parameter.

This command deletes the serv alias from the current session. You can use this command in any Windows PowerShell drive.

remove-item -path alias:serv

If you are in the Alias: drive, you can omit the drive name from the path.

This command deletes aliases that begin with "s". It does not delete read-only aliases.

clear-item -path alias:s*

This command deletes all aliases from the current session, except those with a value of Constant for their Options property. Without the Force parameter, the command does not delete aliases whose Options property has a value of ReadOnly.

remove-item alias:* -force