From 0b8465ed9d2888ff75f5faf46395e73eb2f18831 Mon Sep 17 00:00:00 2001 From: Aleksandar Nikolic Date: Sun, 17 Jul 2016 00:41:20 +0200 Subject: [PATCH 1/7] Update learning-powershell.md Fixing typos and "More Reading" section. --- .../learning-powershell.md | 31 +++++++++---------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/docs/learning-powerShell/learning-powershell.md b/docs/learning-powerShell/learning-powershell.md index 2d3d28341..f1b20f42d 100644 --- a/docs/learning-powerShell/learning-powershell.md +++ b/docs/learning-powerShell/learning-powershell.md @@ -2,20 +2,20 @@ Learning PowerShell ==== Whether you're new to programming or an experienced developer, we'll help you get started with PowerShell. -In this document we'll cover the following: installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. The exercises in this document are intended to give you a solid foundation in how to use PowerShell and get PowerShell to do work for you. You won't be a PowerShell guru at the end of reading this material but you will be well on your way with the right set of knowledge to start using PowerShell. If you have 30 minutes now, let’s try it. +In this document we'll cover the following: installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. The exercises in this document are intended to give you a solid foundation in how to use PowerShell. You won't be a PowerShell guru at the end of reading this material but you will be well on your way with the right set of knowledge to start using PowerShell. If you have 30 minutes now, let’s try it. Installing PowerShell ---- -First you need to setup your computer working environment if you have not done so. Choose the platform below and follow the instructions. At the end of this exercise, you should be able to launch the PowerShell session. +First you need to set up your computer working environment if you have not done so. Choose the platform below and follow the instructions. At the end of this exercise, you should be able to launch the PowerShell session. - [PowerShell on Linux][powershell-on-linux] - [PowerShell on OS X][powershell-on-os-x] - PowerShell on Windows - For this tutorial, you do not need to install PowerShell if you are running on Windows. You can launch PowerShell command console by pressing Windows Key and typing PowerShell, and clicking on 'Windows PowerShell'. + For this tutorial, you do not need to install PowerShell if you are running Windows. You can launch PowerShell command console by pressing Windows Key and typing PowerShell, and clicking on 'Windows PowerShell'. [powershell-on-linux]: https://github.com/PowerShell/PowerShell/blob/master/docs/building/linux.md [powershell-on-os-x]: https://github.com/PowerShell/PowerShell/blob/master/docs/building/osx.md @@ -25,14 +25,14 @@ TODO: Raghu for setup-dev-environment.md Getting Started with PowerShell ---- -PowerShell command has a Verb-Noun structure with a set of parameters. It's easy to learn and use PowerShell. For example, "Get-Process" will display all the running processes on your system. Let's walk through with a few examples by clicking on the [PowerShell Beginner's Guide](powershell-beginners-guide.md). +PowerShell command has a Verb-Noun structure with a set of parameters. It's easy to learn and use PowerShell. For example, `Get-Process` will display all the running processes on your system. Let's walk through with a few examples by clicking on the [PowerShell Beginner's Guide](powershell-beginners-guide.md). Now you have learned the basics of PowerShell. Please continue reading if you want to do some development work in PowerShell. PowerShell Editor ---- -In this section, you will create a PowerShell script using PowerShell editor. You can use your favorite editor to write scripts. As an example, we will use Visual Studio Code (VS Code) which works for Windows, Linux, or OS X. Click on the following link to start create your first PowerShell script, let's say helloworld.ps1. +In this section, you will create a PowerShell script using PowerShell editor. You can use your favorite editor to write scripts. As an example, we will use Visual Studio Code (VS Code) which works for Windows, Linux, or OS X. Click on the following link to create your first PowerShell script. - [Using Visual Studio Code (VS Code)][use-vscode-editor] @@ -44,12 +44,12 @@ On Windows, you can also use [PowerShell Integrated Scripting Environment (ISE)] PowerShell Debugger ---- -Assuming you have written a PowerShell script which may contain a software bug, you can fix the issue via debugging. As an example, we will use VS Code. Click on the link below to start debugging: +Assuming you have written a PowerShell script which may contain a software bug, you can fix the issue by using debugging. As an example, we will use VS Code. 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 [ISE][use-ise-debugger] to debug PowerShell scripts. [use-vscode-debugger]:./using-vscode.md#debugging-with-vs-code [use-ise-debugger]:./using-ise.md#debugging-with-ise @@ -59,7 +59,7 @@ On Windows, you can also use [ISE][use-ise-debugger] to debug PowerShell script PowerShell Testing ---- -We recommend using Pester testing tool which is initiated by the PowerShell Community for writing test cases. To use the tool please read [ Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). +We recommend using Pester testing tool which is initiated by the PowerShell Community for writing test cases. To use the tool please read [Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). Map Book for Experienced Bash users @@ -79,25 +79,24 @@ TODO: Don & JP to fill in More Reading ---- -- Microsoft Virtual Academy: [GetStarted with PowerShell][getstarted-with-powershell] +- Microsoft Virtual Academy: [Getting Started with PowerShell][getstarted-with-powershell] - [Windows PowerShell in Action][in-action] by Bruce Payette -- [Why Learn PowerShell][why-learn-powershell] by Script Guy +- [Why Learn PowerShell][why-learn-powershell] by The Scripting Guys - [Introduction to PowerShell][powershell-intro] from Pluralsight - PowerShell Web Docs: [Basic cookbooks][basic-cookbooks] -- [PowerShell eBooks][ebooks-from-powershell.com] from PowerShell.com +- [PowerShell eBook][ebook-from-powershell.com] from PowerShell.com - [PowerShell Training and Tutorials][lynda-training] from Lynda.com -- [Learn PowerShell][channel9-learn-powershell] from channel9 +- [PowerShell-related Videos][channel9-learn-powershell] on Channel 9 - [Learn PowerShell Video Library][powershell.com-learn-powershell] from PowerShell.com -- [PowerShell Quick Reference][quick-reference] by PowerShellMagazine.com -- [PowerShell 5 How-To Videos][script-guy-how-to] by Script Guy - +- [PowerShell Quick Reference Guides][quick-reference] by PowerShellMagazine.com +- [PowerShell 5 How-To Videos][script-guy-how-to] by The Scripting Guys [getstarted-with-powershell]: https://channel9.msdn.com/Series/GetStartedPowerShell3 [in-action]: https://www.amazon.com/Windows-PowerShell-Action-Second-Payette/dp/1935182137 [why-learn-powershell]: https://blogs.technet.microsoft.com/heyscriptingguy/2014/10/18/weekend-scripter-why-learn-powershell/ [powershell-intro]: https://www.pluralsight.com/courses/powershell-intro [basic-cookbooks]: https://msdn.microsoft.com/en-us/powershell/scripting/getting-started/basic-cookbooks -[ebooks-from-powershell.com]: http://powershell.com/cs/blogs/ebookv2/default.aspx +[ebook-from-powershell.com]: http://powershell.com/cs/blogs/ebookv2/default.aspx [lynda-training]: https://www.lynda.com/PowerShell-training-tutorials/5779-0.html [channel9-learn-powershell]: https://channel9.msdn.com/Search?term=powershell#ch9Search [powershell.com-learn-powershell]: http://powershell.com/cs/media/14/default.aspx From e075e3bcd97c1fa819846a8749e4d6c3fac26951 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aleksandar=20Nikoli=C4=87?= Date: Sun, 17 Jul 2016 02:35:46 +0200 Subject: [PATCH 2/7] Update learning-powershell.md --- docs/learning-powerShell/learning-powershell.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/learning-powerShell/learning-powershell.md b/docs/learning-powerShell/learning-powershell.md index f1b20f42d..aaaedd33d 100644 --- a/docs/learning-powerShell/learning-powershell.md +++ b/docs/learning-powerShell/learning-powershell.md @@ -2,7 +2,10 @@ Learning PowerShell ==== Whether you're new to programming or an experienced developer, we'll help you get started with PowerShell. -In this document we'll cover the following: installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. The exercises in this document are intended to give you a solid foundation in how to use PowerShell. You won't be a PowerShell guru at the end of reading this material but you will be well on your way with the right set of knowledge to start using PowerShell. If you have 30 minutes now, let’s try it. +In this document we'll cover the following: installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. +The exercises in this document are intended to give you a solid foundation in how to use PowerShell. +You won't be a PowerShell guru at the end of reading this material but you will be well on your way with the right set of knowledge to start using PowerShell. +If you have 30 minutes now, let’s try it. Installing PowerShell From 75b9205f7d675562dbb718d8594d9e2da940e4a6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aleksandar=20Nikoli=C4=87?= Date: Sun, 17 Jul 2016 02:44:55 +0200 Subject: [PATCH 3/7] Update learning-powershell.md --- .../learning-powershell.md | 29 +++++++++++++------ 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/docs/learning-powerShell/learning-powershell.md b/docs/learning-powerShell/learning-powershell.md index aaaedd33d..bfb8bee9b 100644 --- a/docs/learning-powerShell/learning-powershell.md +++ b/docs/learning-powerShell/learning-powershell.md @@ -11,14 +11,16 @@ If you have 30 minutes now, let’s try it. Installing PowerShell ---- -First you need to set up your computer working environment if you have not done so. Choose the platform below and follow the instructions. At the end of this exercise, you should be able to launch the PowerShell session. +First you need to set up your computer working environment if you have not done so. +Choose the platform below and follow the instructions. At the end of this exercise, you should be able to launch the PowerShell session. - [PowerShell on Linux][powershell-on-linux] - [PowerShell on OS X][powershell-on-os-x] - PowerShell on Windows - For this tutorial, you do not need to install PowerShell if you are running Windows. You can launch PowerShell command console by pressing Windows Key and typing PowerShell, and clicking on 'Windows PowerShell'. + For this tutorial, you do not need to install PowerShell if you are running Windows. + You can launch PowerShell command console by pressing Windows Key and typing PowerShell, and clicking on 'Windows PowerShell'. [powershell-on-linux]: https://github.com/PowerShell/PowerShell/blob/master/docs/building/linux.md [powershell-on-os-x]: https://github.com/PowerShell/PowerShell/blob/master/docs/building/osx.md @@ -28,14 +30,21 @@ TODO: Raghu for setup-dev-environment.md Getting Started with PowerShell ---- -PowerShell command has a Verb-Noun structure with a set of parameters. It's easy to learn and use PowerShell. For example, `Get-Process` will display all the running processes on your system. Let's walk through with a few examples by clicking on the [PowerShell Beginner's Guide](powershell-beginners-guide.md). +PowerShell command has a Verb-Noun structure with a set of parameters. +It's easy to learn and use PowerShell. +For example, `Get-Process` will display all the running processes on your system. +Let's walk through with a few examples by clicking on the [PowerShell Beginner's Guide](powershell-beginners-guide.md). -Now you have learned the basics of PowerShell. Please continue reading if you want to do some development work in PowerShell. +Now you have learned the basics of PowerShell. +Please continue reading if you want to do some development work in PowerShell. PowerShell Editor ---- -In this section, you will create a PowerShell script using PowerShell editor. You can use your favorite editor to write scripts. As an example, we will use Visual Studio Code (VS Code) which works for Windows, Linux, or OS X. Click on the following link to create your first PowerShell script. +In this section, you will create a PowerShell script using PowerShell editor. +You can use your favorite editor to write scripts. +As an example, we will use Visual Studio Code (VS Code) which works for Windows, Linux, or OS X. +Click on the following link to create your first PowerShell script. - [Using Visual Studio Code (VS Code)][use-vscode-editor] @@ -47,7 +56,9 @@ On Windows, you can also use [PowerShell Integrated Scripting Environment (ISE)] PowerShell Debugger ---- -Assuming you have written a PowerShell script which may contain a software bug, you can fix the issue by using debugging. As an example, we will use VS Code. Click on the link below to learn more about debugging: +Assuming you have written a PowerShell script which may contain a software bug, you can fix the issue by using debugging. +As an example, we will use VS Code. +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] @@ -62,7 +73,8 @@ On Windows, you can also use [ISE][use-ise-debugger] to debug PowerShell scripts PowerShell Testing ---- -We recommend using Pester testing tool which is initiated by the PowerShell Community for writing test cases. To use the tool please read [Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). +We recommend using Pester testing tool which is initiated by the PowerShell Community for writing test cases. +To use the tool please read [Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). Map Book for Experienced Bash users @@ -76,8 +88,7 @@ TODO: Don & JP to fill in | cd |cd |Change directory | mkdir |mkdir |Create a new folder | Clear, Ctrl+L, Reset | cls | Clear screen -| | | | -| | | || + More Reading From 5c63d6c279a6228e5562b11e9b54254df2e2e38a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aleksandar=20Nikoli=C4=87?= Date: Sun, 17 Jul 2016 03:10:55 +0200 Subject: [PATCH 4/7] Update learning-powershell.md --- docs/learning-powerShell/learning-powershell.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/learning-powerShell/learning-powershell.md b/docs/learning-powerShell/learning-powershell.md index bfb8bee9b..8f2944401 100644 --- a/docs/learning-powerShell/learning-powershell.md +++ b/docs/learning-powerShell/learning-powershell.md @@ -2,7 +2,8 @@ Learning PowerShell ==== Whether you're new to programming or an experienced developer, we'll help you get started with PowerShell. -In this document we'll cover the following: installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. +In this document we'll cover the following: +installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. The exercises in this document are intended to give you a solid foundation in how to use PowerShell. You won't be a PowerShell guru at the end of reading this material but you will be well on your way with the right set of knowledge to start using PowerShell. If you have 30 minutes now, let’s try it. From d41ccffb7068214d574bbfdf9aeefc779fde0488 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aleksandar=20Nikoli=C4=87?= Date: Sun, 17 Jul 2016 04:16:00 +0200 Subject: [PATCH 5/7] Update using-vscode.md Adding newlines following one-sentence-per-line principle. --- docs/learning-powerShell/using-vscode.md | 31 ++++++++++++++++++------ 1 file changed, 23 insertions(+), 8 deletions(-) diff --git a/docs/learning-powerShell/using-vscode.md b/docs/learning-powerShell/using-vscode.md index 38a7d3dc4..5a9b2aad7 100644 --- a/docs/learning-powerShell/using-vscode.md +++ b/docs/learning-powerShell/using-vscode.md @@ -1,11 +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. Here we choose VS Code as a PowerShell editor as an example. +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](./learning-powershell.md#installing-powershell) instructions you can install PowerShell and launch a PowerShell session. Editing with VS Code ---- @@ -35,21 +38,32 @@ 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. To exit VS Code, **File->Exit**. +- 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". Thus we select the "demo" folder and open it in 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". +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. In our case, the "demo" 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. It looks like the following: + * 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 { "version": "0.2.0", @@ -75,7 +89,8 @@ Debugging with VS Code ``` - 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. The execution should stop on the line you put the breakpoint on. +- 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. There are a few blogs that may be helpful to get you started using PowerShell extension for VS Code From 7f4288bc8955880828a64e22d13c2529adcf7943 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aleksandar=20Nikoli=C4=87?= Date: Thu, 21 Jul 2016 00:01:28 +0200 Subject: [PATCH 6/7] Update learning-powershell.md Resolving conflicts. --- docs/learning-powerShell/learning-powershell.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/learning-powerShell/learning-powershell.md b/docs/learning-powerShell/learning-powershell.md index 8f2944401..a85a73380 100644 --- a/docs/learning-powerShell/learning-powershell.md +++ b/docs/learning-powerShell/learning-powershell.md @@ -37,13 +37,13 @@ For example, `Get-Process` will display all the running processes on your system Let's walk through with a few examples by clicking on the [PowerShell Beginner's Guide](powershell-beginners-guide.md). Now you have learned the basics of PowerShell. -Please continue reading if you want to do some development work in PowerShell. +Please continue reading: Editor, Debugger, and Testing Tool if you want to do some development work in PowerShell. PowerShell Editor ---- In this section, you will create a PowerShell script using PowerShell editor. -You can use your favorite editor to write scripts. +You can certainly use your favorite editor to write scripts. As an example, we will use Visual Studio Code (VS Code) which works for Windows, Linux, or OS X. Click on the following link to create your first PowerShell script. @@ -57,14 +57,14 @@ On Windows, you can also use [PowerShell Integrated Scripting Environment (ISE)] PowerShell Debugger ---- -Assuming you have written a PowerShell script which may contain a software bug, you can fix the issue by using debugging. +Assuming you have written a PowerShell script which may contains a software bug, you would like to fix the issue by using debugging. As an example, we will use VS Code. 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 [ISE][use-ise-debugger] to debug PowerShell scripts. [use-vscode-debugger]:./using-vscode.md#debugging-with-vs-code [use-ise-debugger]:./using-ise.md#debugging-with-ise @@ -75,7 +75,7 @@ PowerShell Testing ---- We recommend using Pester testing tool which is initiated by the PowerShell Community for writing test cases. -To use the tool please read [Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). +To use the tool please read [ Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). Map Book for Experienced Bash users @@ -89,7 +89,8 @@ TODO: Don & JP to fill in | cd |cd |Change directory | mkdir |mkdir |Create a new folder | Clear, Ctrl+L, Reset | cls | Clear screen - +| | | | +| | | || More Reading @@ -106,6 +107,7 @@ More Reading - [PowerShell Quick Reference Guides][quick-reference] by PowerShellMagazine.com - [PowerShell 5 How-To Videos][script-guy-how-to] by The Scripting Guys + [getstarted-with-powershell]: https://channel9.msdn.com/Series/GetStartedPowerShell3 [in-action]: https://www.amazon.com/Windows-PowerShell-Action-Second-Payette/dp/1935182137 [why-learn-powershell]: https://blogs.technet.microsoft.com/heyscriptingguy/2014/10/18/weekend-scripter-why-learn-powershell/ From b189cce3868dad34c3c70dbe452b204e7cae687a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aleksandar=20Nikoli=C4=87?= Date: Thu, 21 Jul 2016 00:32:15 +0200 Subject: [PATCH 7/7] Update learning-powershell.md Resolving conflicts (second try). --- .../learning-powershell.md | 33 +++++-------------- 1 file changed, 9 insertions(+), 24 deletions(-) diff --git a/docs/learning-powerShell/learning-powershell.md b/docs/learning-powerShell/learning-powershell.md index a85a73380..2fd881243 100644 --- a/docs/learning-powerShell/learning-powershell.md +++ b/docs/learning-powerShell/learning-powershell.md @@ -2,26 +2,20 @@ Learning PowerShell ==== Whether you're new to programming or an experienced developer, we'll help you get started with PowerShell. -In this document we'll cover the following: -installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. -The exercises in this document are intended to give you a solid foundation in how to use PowerShell. -You won't be a PowerShell guru at the end of reading this material but you will be well on your way with the right set of knowledge to start using PowerShell. -If you have 30 minutes now, let’s try it. +In this document we'll cover the following: installing PowerShell, samples walkthrough, PowerShell editor, debugger, testing tools and a map book for experienced bash users to get started with PowerShell faster. The exercises in this document are intended to give you a solid foundation in how to use PowerShell. You won't be a PowerShell guru at the end of reading this material but you will be well on your way with the right set of knowledge to start using PowerShell. If you have 30 minutes now, let’s try it. Installing PowerShell ---- -First you need to set up your computer working environment if you have not done so. -Choose the platform below and follow the instructions. At the end of this exercise, you should be able to launch the PowerShell session. +First you need to set up your computer working environment if you have not done so. Choose the platform below and follow the instructions. At the end of this exercise, you should be able to launch the PowerShell session. - [PowerShell on Linux][powershell-on-linux] - [PowerShell on OS X][powershell-on-os-x] - PowerShell on Windows - For this tutorial, you do not need to install PowerShell if you are running Windows. - You can launch PowerShell command console by pressing Windows Key and typing PowerShell, and clicking on 'Windows PowerShell'. + For this tutorial, you do not need to install PowerShell if you are running on Windows. You can launch PowerShell command console by pressing Windows Key and typing PowerShell, and clicking on 'Windows PowerShell'. [powershell-on-linux]: https://github.com/PowerShell/PowerShell/blob/master/docs/building/linux.md [powershell-on-os-x]: https://github.com/PowerShell/PowerShell/blob/master/docs/building/osx.md @@ -31,21 +25,14 @@ TODO: Raghu for setup-dev-environment.md Getting Started with PowerShell ---- -PowerShell command has a Verb-Noun structure with a set of parameters. -It's easy to learn and use PowerShell. -For example, `Get-Process` will display all the running processes on your system. -Let's walk through with a few examples by clicking on the [PowerShell Beginner's Guide](powershell-beginners-guide.md). +PowerShell command has a Verb-Noun structure with a set of parameters. It's easy to learn and use PowerShell. For example, `Get-Process` will display all the running processes on your system. Let's walk through with a few examples by clicking on the [PowerShell Beginner's Guide](powershell-beginners-guide.md). -Now you have learned the basics of PowerShell. -Please continue reading: Editor, Debugger, and Testing Tool if you want to do some development work in PowerShell. +Now you have learned the basics of PowerShell. Please continue reading: Editor, Debugger, and Testing Tool if you want to do some development work in PowerShell. PowerShell Editor ---- -In this section, you will create a PowerShell script using PowerShell editor. -You can certainly use your favorite editor to write scripts. -As an example, we will use Visual Studio Code (VS Code) which works for Windows, Linux, or OS X. -Click on the following link to create your first PowerShell script. +In this section, you will create a PowerShell script using PowerShell editor. You can certainly use your favorite editor to write scripts. As an example, we use Visual Studio Code (VS Code) which works on Windows, Linux, or OS X. Click on the following link to create your first PowerShell script. - [Using Visual Studio Code (VS Code)][use-vscode-editor] @@ -57,9 +44,7 @@ On Windows, you can also use [PowerShell Integrated Scripting Environment (ISE)] PowerShell Debugger ---- -Assuming you have written a PowerShell script which may contains a software bug, you would like to fix the issue by using debugging. -As an example, we will use VS Code. -Click on the link below to learn more about debugging: +Assuming you have written a PowerShell script which may contains a software bug, you would like to fix the issue by using debugging. As an example, we use VS Code. 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] @@ -74,8 +59,7 @@ On Windows, you can also use [ISE][use-ise-debugger] to debug PowerShell script PowerShell Testing ---- -We recommend using Pester testing tool which is initiated by the PowerShell Community for writing test cases. -To use the tool please read [ Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). +We recommend using Pester testing tool which is initiated by the PowerShell Community for writing test cases. To use the tool please read [ Pester Guides](https://github.com/pester/Pester) and [Writing Pester Tests Guidelines](https://github.com/PowerShell/PowerShell/blob/master/docs/testing-guidelines/WritingPesterTests.md). Map Book for Experienced Bash users @@ -119,3 +103,4 @@ More Reading [powershell.com-learn-powershell]: http://powershell.com/cs/media/14/default.aspx [quick-reference]: http://www.powershellmagazine.com/2014/04/24/windows-powershell-4-0-and-other-quick-reference-guides/ [script-guy-how-to]:https://blogs.technet.microsoft.com/tommypatterson/2015/09/04/ed-wilsons-powershell5-videos-now-on-channel9-2/ +