fixed the broken links and other minor updates due to the recent learning-powershell path changes.

This commit is contained in:
Jianyun Tao
2016-08-01 11:21:55 -07:00
parent bc4fe11888
commit 1e7a49600d
7 changed files with 44 additions and 48 deletions
+6 -6
View File
@@ -52,11 +52,6 @@ Click on the following link to create your first PowerShell script.
- [Using Visual Studio Code (VS Code)][use-vscode-editor]
On Windows, you can also use [PowerShell Integrated Scripting Environment (ISE)][use-ise-editor] to edit PowerShell scripts.
[use-vscode-editor]:./using-vscode.md#editing-with-vs-code
[use-ise-editor]:./using-ise.md#editing-with-ise
PowerShell Debugger
----
@@ -66,11 +61,16 @@ Click on the link below to learn more about debugging:
- [Using Visual Studio Code (VS Code)][use-vscode-debugger]
- [PowerShell Command-line Debugging][cli-debugging]
On Windows, you can also use [ISE][use-ise-debugger] to debug PowerShell scripts.
On Windows, you can also use [PowerShell Integrated Scripting Environment (ISE)][use-ise-editor] to edit or debug PowerShell scripts.
However it is not supported if you are using PowerShell installed from the [PowerShell package][get-powershell] or directly [built][building-the-repository] from GitHub.
[use-vscode-editor]:./using-vscode.md#editing-with-vs-code
[use-ise-editor]:./using-ise.md#editing-with-ise
[use-vscode-debugger]:./using-vscode.md#debugging-with-vs-code
[use-ise-debugger]:./using-ise.md#debugging-with-ise
[cli-debugging]:./debugging-from-commandline.md
[get-powershell]:../../README.md#get-powershell
[build-powershell]:../../README.md#building-the-repository
PowerShell Testing
@@ -23,7 +23,7 @@ Write-Host "$result Celsius"
**1. Setting a Breakpoint on a Line**
- Open a [PowerShell editor](learning-powershell.md#powershell-editor)
- Open a [PowerShell editor](README.md#powershell-editor)
- Save the above code snippet to a file. For example, "test.ps1"
- Go to your command-line PowerShell
- Clear existing breakpoints if any
@@ -54,7 +54,7 @@ At /home/jen/debug/test.ps1:5 char:1
[DBG]: PS /home/jen/debug>>
```
- The PowerShell prompt now has the prefix **[DBG]:** as you may noticed. This means
- The PowerShell prompt now has the prefix **[DBG]:** as you may have noticed. This means
we have entered into the debug mode. To watch the variables like $celsius, simply type **$celsius** as below.
- To exit from the debugging, type **q**
- To get help for the debugging commands, simply type **?**. The following is an example of debugging output.
@@ -7,7 +7,7 @@ We recommend that you open a PowerShell console/session and type along with the
Launch PowerShell Console/Session
---
First you need to launch a PowerShell session by following the [Installing PowerShell Guide](./learning-powershell.md#installing-powershell).
First you need to launch a PowerShell session by following the [Installing PowerShell Guide](./README.md#installing-powershell).
Getting Familiar with PowerShell Commands
@@ -20,7 +20,7 @@ In this section, you will learn how to
- find syntax of PowerShell cmdlets
- and more
As mentioned above, PowerShell commands are designed to have Verb-Noun structure, for instance Get-Process, Set-Location, Clear-Host, etc.
As mentioned above, PowerShell commands are designed to have Verb-Noun structure, for instance Get-Process, Set-Location, Clear-Host, etc.
Let’s exercise some of the basic PowerShell commands, also known as **cmdlets**.
Please note that we will use the PowerShell prompt sign **PS />** as it appears on Linux in the following examples.
@@ -213,7 +213,7 @@ PS /> Get-Help -Name Get-Process
It displays the examples how to use the Get-Process cmdlet.
```PowerShell
PS />**Get-Help -Name Get-Process -Examples**
PS />Get-Help -Name Get-Process -Examples
```
If you use **-Full** parameter, for example, `Get-Help -Name Get-Process -Full`, it will display more technical information.
+3
View File
@@ -1,6 +1,7 @@
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](./using-vscode.md).
Please note the ISE is not supported if you are using PowerShell installed from the [PowerShell package][get-powershell] or directly [built][building-the-repository] from GitHub.
Editing with ISE
---
@@ -72,3 +73,5 @@ PS C:\test>
See [How to Debug in ISE][debug] for more information.
[debug]:https://msdn.microsoft.com/en-us/powershell/scripting/core-powershell/ise/how-to-debug-scripts-in-windows-powershell-ise#bkmk_2
[get-powershell]:../../README.md#get-powershell
[build-powershell]:../../README.md#building-the-repository
+18 -18
View File
@@ -1,14 +1,14 @@
Using Visual Studio Code (VS Code)
====
If you are working on Linux and OS X, you cannot use ISE because it is not supported on these platforms.
In this case, you can choose your favorite editor to write PowerShell scripts.
If you are working on Linux and OS X, you cannot use ISE because it is not supported on these platforms.
In this case, you can choose your favorite editor to write PowerShell scripts.
Here we choose VS Code as a PowerShell editor as an example.
You can use VS Code on Windows with PowerShell V5 by using Windows 10 or by installing [Windows Management Framework 5.0 RTM](https://www.microsoft.com/en-us/download/details.aspx?id=50395) for down-level Windows OSs (e.g. Windows 8.1, etc.).
Before starting it, please make sure PowerShell exists on your system.
By following the [Installing PowerShell](./learning-powershell.md#installing-powershell) instructions you can install PowerShell and launch a PowerShell session.
Before starting it, please make sure PowerShell exists on your system.
By following the [Installing PowerShell](./README.md#installing-powershell) instructions you can install PowerShell and launch a PowerShell session.
Editing with VS Code
----
@@ -38,31 +38,31 @@ Editing with VS Code
- After the install, you will see the **Install** button turns to **Enable**.
- Click on **Enable** and **OK**
- Now you are ready for editing.
For example, to create a new file, click **File->New**.
To save it, click **File->Save** and then provide a file name, let's say "helloworld.ps1".
To close the file, click on "x" next to the file name.
- Now you are ready for editing.
For example, to create a new file, click **File->New**.
To save it, click **File->Save** and then provide a file name, let's say "helloworld.ps1".
To close the file, click on "x" next to the file name.
To exit VS Code, **File->Exit**.
Debugging with VS Code
----
- Open a file folder (**File->Open Folder**) that contains the PowerShell modules or scripts you have written already and want to debug.
In this example, we saved the helloworld.ps1 under a directory called "demo".
- Open a file folder (**File->Open Folder**) that contains the PowerShell modules or scripts you have written already and want to debug.
In this example, we saved the helloworld.ps1 under a directory called "demo".
Thus we select the "demo" folder and open it in VS Code.
- Creating the Debug Configuration (launch.json)
Because some information regarding your scripts is needed for debugger to start executing your script, we need to set up the debug config first.
This is one-time process to debug PowerShell scripts under your current folder.
Because some information regarding your scripts is needed for debugger to start executing your script, we need to set up the debug config first.
This is one-time process to debug PowerShell scripts under your current folder.
In our case, the "demo" folder.
* Click on the **Debug** icon (or **Ctrl+Shift+D**)
* Click on the **Settings** icon that looks like a gear.
VS Code will prompt you to **Select Environment**.
Choose **PowerShell**.
Then VS code will auto create a debug configuration settings file in the same folder.
* Click on the **Settings** icon that looks like a gear.
VS Code will prompt you to **Select Environment**.
Choose **PowerShell**.
Then VS code will auto create a debug configuration settings file in the same folder.
It looks like the following:
```json
{
@@ -89,7 +89,7 @@ It looks like the following:
```
- Once the debug configuration is established, go to your helloworld.ps1 and set a breakpoint by pressing **F9** on a line you wish to debug.
- To disable the breakpoint, press **F9** again.
- Press **F5** to run the script.
- Press **F5** to run the script.
The execution should stop on the line you put the breakpoint on.
- Press **F5** to continue running the script.
@@ -109,4 +109,4 @@ There are a few blogs that may be helpful to get you started using PowerShell ex
PowerShell Extension for VS Code
----
PowerShell extension source code can be found [GitHub](https://github.com/PowerShell/vscode-powershell-ops)
PowerShell extension source code can be found [GitHub](https://github.com/PowerShell/vscode-powershell-ops).