Topics: Windows PowerShell, Path, Parameter Pages: 9 (1613 words) Published: October 25, 2013

Describes how to write and run scripts in Windows PowerShell.

A script is a plain text file that contains one or more Windows PowerShell commands. Windows PowerShell scripts have a .ps1 file name extension.

Writing a script saves a command for later use and makes it easy to share with others. Most importantly, it lets you run the commands simply by typing the script path and the file name. Scripts can be as simple as a single command in a file or as extensive as a complex program.

Scripts have additional features, such as the #Requires special comment, the use of parameters, support for data sections, and digital signing for security. You can also write Help topics for scripts and for any functions in the script.


A script can contain any valid Windows PowerShell commands, including single commands, commands that use the pipeline, functions, and control structures such as If statements and For loops.

To write a script, start a text editor (such as Notepad) or a script editor (such as the Windows PowerShell Integrated Scripting Environment [ISE]). Type the commands and save them in a file with a valid file name and the .ps1 file name extension.

The following example is a simple script that gets the services that are running on the current system and saves them to a log file. The log file name is created from the current date.

$date = (get-date).dayofyear
get-service | out-file "$date.log"

To create this script, open a text editor or a script editor, type these commands, and then save them in a file named ServiceLog.ps1.


Before you can run a script, you need to change the default Windows PowerShell execution policy. The default execution policy, "Restricted", prevents all scripts from running, including scripts that you write on the local computer. For more information, see about_Execution_Policies.

To run a script, type the full name and the full path to the script file.

For example, to run the ServicesLog script in the C:\Scripts directory, type:


To run a script in the current directory, type the path to the current directory, or use a dot to represent the current directory, followed by a path backslash (.\).

For example, to run the ServicesLog.ps1 script in the local directory, type:


As a security feature, Windows PowerShell does not run scripts when you double-click the script icon in Windows Explorer or when you type the script name without a full path, even when the script is in the current directory. For more information about running commands and scripts in Windows PowerShell, see about_Command_Precedence.


To run a script on a remote computer, use the FilePath parameter of the Invoke-Command cmdlet.

Enter the path and file name of the script as the value of the FilePath parameter. The script must reside on the local computer or in a directory that the local computer can access.

The following command runs the ServicesLog.ps1 script on the Server01 remote computer.

invoke-command -computername Server01 -filepath C:\scripts\servicesLog.ps1


To define parameters in a script, use a Param statement. The Param statement must be the first statement in a script, except for comments and any #Requires statements.

Script parameters work like function parameters. The parameter values are available to all of the commands in the script. All of the features of function parameters, including the Parameter attribute and its named arguments, are also valid in scripts.

When running the...
Continue Reading

Please join StudyMode to read the full document

You May Also Find These Documents Helpful

  • Basic Winshuttle Script Creation Essay
  • Essay on Bharathiar University: Application for Requesting Answer Script Xerox and Revaluation
  • Template for Documentary 2-Column Film/Video Scripts Essay
  • Express Scripts Research Paper
  • Essay on Cuneiform Script
  • Real Time Romanised Malay Script to Jawi Script Converter Essay
  • Essay about Wicked Cool Shell Scripts
  • script Essay

Become a StudyMode Member

Sign Up - It's Free