PowerShell/docs/learning-powershell/using-ise.md

Using PowerShell Integrated Scripting Environment (ISE)

The PowerShell ISE only works on Windows. If you are not using Windows, please see Using Visual Studio Code.

Editing with ISE

• Launch PowerShell ISE

• Press Windows Key -> type "PowerShell ISE", click on PowerShell ISE to launch the ISE

• Create a new PowerShell Script

• Click on File->New
• Add a few lines of PowerShell code in your newly created file. In this case, we will use the following script snippet.

# Convert Fahrenheit to Celsius
function ConvertFahrenheitToCelsius([double] $fahrenheit)
{
$celsius = $fahrenheit - 32
$celsius = $celsius / 1.8
$celsius
}

$fahrenheit = Read-Host 'Input a temperature in Fahrenheit'
$result =[int](ConvertFahrenheitToCelsius($fahrenheit))
Write-Host "$result Celsius"

• Note: You can find more examples here.

• To save the script file

• Click on File->Save As. Then type "helloworld.ps1"

• To close the helloworld.ps1 file

• File->Close

• To reopen the helloworld.ps1 file

• File->Open, then choose helloworld.ps1

• For more details, go to How to Write and Run Scripts in the Windows PowerShell ISE.

Debugging with ISE

To execute the entire script file, you can press F5. To execute several lines of your scripts, simply select them and press F8. If you would like to stop the execution on a particular line in order to examine some variables to check if the program runs as expected. In that case, you may follow the steps below. Let's take the helloworld.ps1 as an example and assume line 17 is the place where you want to stop.

• Set a break point: Move mouse over on the line 17, and press F9. You will see the line 17 is highlighted, which means a breakpoint is set.
• Press F5 to run the script
• Enter 80 (or any number in Fahrenheit) from the command line prompt
• Notice that the ISE output pane becomes “[DBG]: PS C:\Test>>” prompt. This means the program is in the debugging mode. It stops at Line 17:

PS C:\test> C:\test\helloword.ps1
Input a temperature in Fahrenheit: 80
Hit Line breakpoint on 'C:\test\helloword.ps1:17'
''[DBG]: PS C:\test>>'

• From the output pane, you can type $celsius and $fahrenheit to examine the values of these variables to see if they are correct.

[DBG]: PS C:\Test>> $celsius
26.6666666666667

[DBG]: PS C:\Tset>> $fahrenheit
80

• Press F5 to let the program continue running

[DBG]: PS C:\test>>
27 Celsius

PS C:\test>

See How to Debug in ISE for more information.