diff --git a/reference/docs-conceptual/PowerShell-Scripting.md b/reference/docs-conceptual/PowerShell-Scripting.md index 1aec459e9c4c..21b90280edf9 100644 --- a/reference/docs-conceptual/PowerShell-Scripting.md +++ b/reference/docs-conceptual/PowerShell-Scripting.md @@ -6,64 +6,56 @@ title: PowerShell Scripting # PowerShell -Built on the .NET Framework, -Windows PowerShell is a task-based command-line shell and scripting language; -it is designed specifically for system administrators and power-users, -to rapidly automate the administration of multiple operating systems -(Linux, macOS, Unix, and Windows) -and the processes related to the applications that run on those operating systems. +Built on the .NET Framework, PowerShell is a task-based command-line shell and scripting language; +it is designed specifically for system administrators and power-users, to rapidly automate the +administration of multiple operating systems (Linux, macOS, Unix, and Windows) and the processes +related to the applications that run on those operating systems. -### PowerShell is now open source +## PowerShell is open source PowerShell base source code is now available in GitHub and open to community -contributions, see [PowerShell](https://github.com/powershell/powershell). +contributions. See [PowerShell source on GitHub](https://github.com/powershell/powershell). You can start with the bits you need at [get PowerShell](https://github.com/PowerShell/PowerShell#get-powershell). Or, perhaps, with a quick tour at [Getting Started](https://github.com/PowerShell/PowerShell/blob/master/docs/learning-powershell) -> **Note:** -> All links about PowerShell in GitHub will take you to GitHub. - -# Documentation - -The documentation collection is organized around 4 main sections: - -## [What's new with PowerShell](whats-new/What-s-New-With-PowerShell.md) -In this section you'll find all announcements about the product (version by -version and release by release). - -## [PowerShell Setup](setup/setup-reference.md) -In this section you'll find all you need to know to install all -versions of PowerShell, in all supported environments. - -You will also find how to configure for: security, accessibility, remote access -and management, workflows, and web access. - -## [Getting started with PowerShell](getting-started/Getting-Started-with-Windows-PowerShell.md) -This section is for users new to PowerShell to get all the information needed -to start using the product. -In this section: -- The [Getting Ready to Use Windows PowerShell](getting-started/Getting-Ready-to-Use-Windows-PowerShell.md) -that explains the necessary steps needed to setup PowerShell to execute and try -all code and command snippets presented in the 'Getting Started with PowerShell' -section. -- The [fundamental concepts](getting-started/fundamental-concepts.md) guide that -explains what is PowerShell and the basic concepts needed to start using it. -- A series of '[understanding <concept>](getting-started/understanding-concepts-reference.md)' topics -that cover the basics of PowerShell. -- A series of '[basic cookbook for <usage>](getting-started/cookbooks/basic-cookbooks-reference.md)' -topics that provide recipes to execute standard tasks around files, file system, -registry, processes, services, and similar day-to-day subjects. -- A curated guide to other sources for -[learning PowerShell](getting-started/more-powershell-learning.md). - -## [Common PowerShell](core-powershell/core-powershell.md) -This section contains all reference material PowerShell. -Find in this section: -- The [PowerShell Integrated Scripting Environment \(ISE\)](core-powershell/ise-guide.md) -- The [PowerShell Console Window](core-powershell/console-guide.md) -- The [PowerShell Remote Management](core-powershell/Running-Remote-Commands.md) -- The [PowerShell Workflows](core-powershell/workflows-guide.md) -- The [PowerShell Web Access](core-powershell/web-access.md) -- The [PowerShell Glossary](Windows-PowerShell-Glossary.md) +## PowerShell design goals +Windows PowerShell is designed to improve the command-line and scripting environment by eliminating long-standing problems and adding new features. +### Discoverability +Windows PowerShell makes it easy to discover its features. For example, to find a list of cmdlets that view and change Windows services, type: + +``` +Get-Command *-Service +``` + +After discovering which cmdlet accomplishes a task, you can learn more about the cmdlet by using the Get-Help cmdlet. For example, to display help about the Get-Service cmdlet, type: + +``` +Get-Help Get-Service +``` +Most cmdlets emit objects which can be manipulated and then rendered into text for display. To fully understand the output of that cmdlet, pipe its output to the Get-Member cmdlet. For example, the following command displays information about the members of the object output by the Get-Service cmdlet. + +``` +Get-Service | Get-Member +``` + +### Consistency +Managing systems can be a complex endeavor and tools that have a consistent interface help to control the inherent complexity. Unfortunately, neither command-line tools nor scriptable COM objects have been known for their consistency. + +The consistency of Windows PowerShell is one of its primary assets. For example, if you learn how to use the Sort-Object cmdlet, you can use that knowledge to sort the output of any cmdlet. You do not have to learn the different sorting routines of each cmdlet. + +In addition, cmdlet developers do not have to design sorting features for their cmdlets. Windows PowerShell gives them a framework that provides the basic features and forces them to be consistent about many aspects of the interface. The framework eliminates some of the choices that are typically left to the developer, but, in return, it makes the development of robust and easy-to-use cmdlets much simpler. + +### Interactive and Scripting Environments +Windows PowerShell is a combined interactive and scripting environment that gives you access to command-line tools and COM objects, and also enables you to use the power of the .NET Framework Class Library (FCL). + +This environment improves upon the Windows Command Prompt, which provides an interactive environment with multiple command-line tools. It also improves upon Windows Script Host (WSH) scripts, which let you use multiple command-line tools and COM automation objects, but do not provide an interactive environment. + +By combining access to all of these features, Windows PowerShell extends the ability of the interactive user and the script writer, and makes system administration more manageable. + +### Object Orientation +Although you interact with Windows PowerShell by typing commands in text, Windows PowerShell is based on objects, not text. The output of a command is an object. You can send the output object to another command as its input. As a result, Windows PowerShell provides a familiar interface to people experienced with other shells, while introducing a new and powerful command-line paradigm. It extends the concept of sending data between commands by enabling you to send objects, rather than text. + +### Easy Transition to Scripting +Windows PowerShell makes it easy to transition from typing commands interactively to creating and running scripts. You can type commands at the Windows PowerShell command prompt to discover the commands that perform a task. Then, you can save those commands in a transcript or a history before copying them to a file for use as a script. diff --git a/reference/docs-conceptual/core-powershell/core-powershell.md b/reference/docs-conceptual/core-powershell/core-powershell.md deleted file mode 100644 index 61d571df96e8..000000000000 --- a/reference/docs-conceptual/core-powershell/core-powershell.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: core powershell ---- - -# Common PowerShell -This section contains all reference material and in-depth guides for PowerShell. -Find in this section: -- The [PowerShell Integrated Scripting Environment -ISE-](ise-guide.md) -- The [PowerShell Console Window](console-guide.md) -- The [PowerShell Remote Management](Running-Remote-Commands.md) -- The [PowerShell Workflows](workflows-guide.md) -- The [PowerShell Web Access](web-access.md) -- The [PowerShell Glossary](../Windows-PowerShell-Glossary.md) - diff --git a/reference/docs-conceptual/core-powershell/ise/ISE-Module.md b/reference/docs-conceptual/core-powershell/ise/ISE-Module.md deleted file mode 100644 index 6ff73451d97d..000000000000 --- a/reference/docs-conceptual/core-powershell/ise/ISE-Module.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: ISE Module -ms.assetid: fd03c995-4cdb-4d14-a315-9cfbd1e81b10 ---- - -# ISE Module -This section contains the help topics for the **ISE** module, which includes commands that you can use in Windows PowerShell Integrated Scripting Environment (ISE). The **ISE** module is installed with Windows PowerShell. - -## Help Topics -[ISE Cmdlets](http://go.microsoft.com/fwlink/?LinkID=254686) - -## See Also -- [about_Windows_PowerShell_ISE [v3]](https://technet.microsoft.com/en-us/library/dfa54d47-60c6-4fff-8197-c747e8d411bb) -- [Windows PowerShell 3.0 Integrated Scripting Environment](http://go.microsoft.com/fwlink/?LinkId=254681) -- [Windows PowerShell 2.0 Integrated Scripting Environment](http://go.microsoft.com/fwlink/?LinkID=238569) -- [Windows PowerShell 5.0](../../whats-new/What-s-New-in-Windows-PowerShell-50.md) -- [Windows PowerShell Core](https://technet.microsoft.com/en-us/library/4b75f1e4-f327-48f3-92ab-bf5435094d41) -- [Scripting with Windows PowerShell](../../getting-started/fundamental/Scripting-with-Windows-PowerShell.md) - diff --git a/reference/docs-conceptual/core-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md b/reference/docs-conceptual/core-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md index 8c4604f8901d..bd1a7e2d3a2f 100644 --- a/reference/docs-conceptual/core-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/core-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md @@ -5,28 +5,39 @@ title: Introducing the Windows PowerShell ISE --- # Introducing the Windows PowerShell ISE -The Windows PowerShell Integrated Scripting Environment (ISE) is a host application for Windows PowerShell. In Windows PowerShell ISE, you can run commands and write, test, and debug scripts in a single Windows-based graphic user interface with multiline editing, tab completion, syntax coloring, selective execution, context-sensitive help, and support for right-to-left languages. -You can use menu items and keyboard shortcuts to perform many of the same tasks that you would perform in the Windows PowerShell console.  For example, when you debug a script in the Windows PowerShell ISE, to set a line breakpoint in a script, right-click the line of code, and then click **Toggle Breakpoint**. -Try these features in Windows PowerShell ISE. - -- Multiline editing: To insert a blank line under the current line in the Command pane, press SHIFT+ENTER. +The Windows PowerShell Integrated Scripting Environment (ISE) is a host application for Windows +PowerShell. In Windows PowerShell ISE, you can run commands and write, test, and debug scripts in a +single Windows-based graphic user interface with multiline editing, tab completion, syntax +coloring, selective execution, context-sensitive help, and support for right-to-left languages. You +can use menu items and keyboard shortcuts to perform many of the same tasks that you would perform +in the Windows PowerShell console. For example, when you debug a script in the Windows PowerShell +ISE, to set a line breakpoint in a script, right-click the line of code, and then click **Toggle +Breakpoint**. -- Selective execution: To run part of a script, select the text you want to run, and then click the **Run Script** button. Or, press F5. +Try these features in Windows PowerShell ISE. -- Context-sensitive help: Type **Invoke-Item**, and then press F1. The Help file opens to the Help topic for the **Invoke-Item** cmdlet. +- Multiline editing: To insert a blank line under the current line in the Command pane, press + SHIFT+ENTER. +- Selective execution: To run part of a script, select the text you want to run, and then click the + **Run Script** button. Or, press F5. +- Context-sensitive help: Type **Invoke-Item**, and then press F1. The Help file opens to the Help + topic for the **Invoke-Item** cmdlet. -The Windows PowerShell ISE lets you customize some aspects of its appearance. It also has its own Windows PowerShell profile, where you can store functions, aliases, variables, and commands you use in the Windows PowerShell ISE. +The Windows PowerShell ISE lets you customize some aspects of its appearance. It also has its own +Windows PowerShell profile, where you can store functions, aliases, variables, and commands you use +in the Windows PowerShell ISE. ### To start the Windows PowerShell ISE -1. Do one of the following: +Do one of the following: - - Click **Start**, point to **All Programs**, point to **Windows PowerShell V2**, and then click **Windows PowerShell ISE**. - - - In the Windows PowerShell console Cmd.exe, or in the Run box, type, **powershell_ise.exe**. +- Click **Start**, point to **All Programs**, point to **Windows PowerShell V2**, and then click + **Windows PowerShell ISE**. +- In the Windows PowerShell console Cmd.exe, or in the Run box, type, **powershell_ise.exe**. ### To get Help in the Windows PowerShell ISE -- On the **Help** menu, click **Windows PowerShell Help**. Or, press F1. The file that opens describes Windows PowerShell ISE and Windows PowerShell, including all of the help available from the Get-Help cmdlet. - +On the **Help** menu, click **Windows PowerShell Help**. Or, press F1. The file that opens +describes Windows PowerShell ISE and Windows PowerShell, including all of the help available from +the Get-Help cmdlet. diff --git a/reference/docs-conceptual/core-powershell/ise/Purpose-of-the-Windows-PowerShell-ISE-Scripting-Object-Model.md b/reference/docs-conceptual/core-powershell/ise/Purpose-of-the-Windows-PowerShell-ISE-Scripting-Object-Model.md index 1d9059389e49..e6022ff9f723 100644 --- a/reference/docs-conceptual/core-powershell/ise/Purpose-of-the-Windows-PowerShell-ISE-Scripting-Object-Model.md +++ b/reference/docs-conceptual/core-powershell/ise/Purpose-of-the-Windows-PowerShell-ISE-Scripting-Object-Model.md @@ -6,64 +6,59 @@ ms.assetid: d176a131-ab0c-43ee-80c1-f824ab8e4a05 --- # Purpose of the Windows PowerShell ISE Scripting Object Model - Objects are associated with the form and function of Windows PowerShell Integrated Scripting Environment (ISE). The object model reference provides details about the member properties and methods that these objects expose. Examples are provided to show how you can use scripts to directly access these methods and properties. The scripting object model makes the following range of tasks easier. + +Objects are associated with the form and function of Windows PowerShell Integrated Scripting +Environment (ISE). The object model reference provides details about the member properties and +methods that these objects expose. Examples are provided to show how you can use scripts to +directly access these methods and properties. The scripting object model makes the following range +of tasks easier. ## Customizing the appearance of Windows PowerShell ISE - You can use the object model to modify the application settings and options. For example, you can modify them as follows: -- You can change the color of errors, warnings, verbose outputs, and debug outputs. +You can use the object model to modify the application settings and options. For example, you can +modify them as follows: +- You can change the color of errors, warnings, verbose outputs, and debug outputs. - You can get or set the background colors for the Command pane, the Output pane, and the Script pane. - - You can set the foreground color for the Output pane. - - You can set the font name and font size for Windows PowerShell ISE. - -- You can configure warnings. This setting includes warnings that are issued when a file is opened in multiple PowerShell tabs or when a script in the file is run before the file has been saved. - -- You can switch between a view where the Script pane and the Output pane are side-by-side and a view where the Script pane is on top of the Output pane. You can dock the Command pane to the bottom or the top of the Output pane. +- You can configure warnings. This setting includes warnings that are issued when a file is opened + in multiple PowerShell tabs or when a script in the file is run before the file has been saved. +- You can switch between a view where the Script pane and the Output pane are side-by-side and a + view where the Script pane is on top of the Output pane. You can dock the Command pane to the + bottom or the top of the Output pane. ## Enhancing the functionality of Windows PowerShell ISE - You can use the object model to enhance the functionality of Windows PowerShell ISE. For example, you can: - -- Add and modify the instance of Windows PowerShell ISE itself. For example, to change the menus, you can add new menu items and map the new menu items to scripts. - -- Create scripts that perform some of the tasks that you can perform by using the menu commands and buttons in Windows PowerShell ISE. For example, you can add, remove, or select a PowerShell tab. - -- Complement tasks that can be performed by using menu commands and buttons. For example, you can rename a PowerShell tab. - -- Manipulate text buffers for the Command pane, the Output pane, and the Script pane that are associated with a file. For example, you can: - - - Get or set all text. - - - Get or set a text selection. - - - Run a script or run a selected portion of a script. - - - Scroll a line into view. - - - Insert text at a caret position. - - - Select a block of text. - - - Get the last line number. +You can use the object model to enhance the functionality of Windows PowerShell ISE. For example, +you can: + +- Add and modify the instance of Windows PowerShell ISE itself. For example, to change the menus, + you can add new menu items and map the new menu items to scripts. +- Create scripts that perform some of the tasks that you can perform by using the menu commands and + buttons in Windows PowerShell ISE. For example, you can add, remove, or select a PowerShell tab. +- Complement tasks that can be performed by using menu commands and buttons. For example, you can + rename a PowerShell tab. +- Manipulate text buffers for the Command pane, the Output pane, and the Script pane that are + associated with a file. For example, you can: + - Get or set all text. + - Get or set a text selection. + - Run a script or run a selected portion of a script. + - Scroll a line into view. + - Insert text at a caret position. + - Select a block of text. + - Get the last line number. - Perform file operations. For example, you can: - - - Open a file, save a file, or save a file by using a different name. - - - Determine whether a file has been changed after it was last saved. - - - Get the file name. - - - Select a file. + - Open a file, save a file, or save a file by using a different name. + - Determine whether a file has been changed after it was last saved. + - Get the file name. + - Select a file. ## Automating tasks - You can use the scripting object model to create keyboard shortcuts for frequent operations. -## See Also -- [The ISE Object Model Hierarchy](The-ISE-Object-Model-Hierarchy.md) -- [Windows PowerShell ISE Object Model Reference](Windows-PowerShell-ISE-Object-Model-Reference.md) -- [The Windows PowerShell ISE Scripting Object Model](The-Windows-PowerShell-ISE-Scripting-Object-Model.md) +You can use the scripting object model to create keyboard shortcuts for frequent operations. - +## See also +- [The ISE Object Model Hierarchy](The-ISE-Object-Model-Hierarchy.md) +- [Windows PowerShell ISE Object Model Reference](Windows-PowerShell-ISE-Object-Model-Reference.md) +- [The Windows PowerShell ISE Scripting Object Model](The-Windows-PowerShell-ISE-Scripting-Object-Model.md) diff --git a/reference/docs-conceptual/core-powershell/ise/The-Windows-PowerShell-ISE-Scripting-Object-Model.md b/reference/docs-conceptual/core-powershell/ise/The-Windows-PowerShell-ISE-Scripting-Object-Model.md deleted file mode 100644 index 31464a543a42..000000000000 --- a/reference/docs-conceptual/core-powershell/ise/The-Windows-PowerShell-ISE-Scripting-Object-Model.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: The Windows PowerShell ISE Scripting Object Model -ms.assetid: 69b047d0-da79-413e-b948-8e45d05d1f85 ---- - -# The Windows PowerShell ISE Scripting Object Model - The Windows PowerShell® Integrated Scripting Environment (ISE) exposes its functionality through an underlying scripting object model that enables users to write Windows PowerShell scripts that manipulate the various visual and functional aspects of the Windows PowerShell ISE. Scripting objects, their properties, and their methods are defined specifically for this purpose. - -## In this document - -- [Purpose of the Windows PowerShell ISE Scripting Object Model](Purpose-of-the-Windows-PowerShell-ISE-Scripting-Object-Model.md) - -- [The ISE Object Model Hierarchy](The-ISE-Object-Model-Hierarchy.md) - -- [Windows PowerShell ISE Object Model Reference](Windows-PowerShell-ISE-Object-Model-Reference.md) - -- [Other Useful Scripting Objects](../../getting-started/cookbooks/Other-Useful-Scripting-Objects.md) - -## See Also -- [Windows PowerShell Integrated Scripting Environment (ISE)](../../getting-started/fundamental/Windows-PowerShell-Integrated-Scripting-Environment--ISE-.md) - - diff --git a/reference/docs-conceptual/core-powershell/ise/Using-the-Windows-PowerShell-ISE.md b/reference/docs-conceptual/core-powershell/ise/Using-the-Windows-PowerShell-ISE.md deleted file mode 100644 index 8929fec1c4fc..000000000000 --- a/reference/docs-conceptual/core-powershell/ise/Using-the-Windows-PowerShell-ISE.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: Using the Windows PowerShell ISE -ms.assetid: 64fb5f37-90a8-4b89-9fc8-c6b8fcc0c7d0 ---- - -# Using the Windows PowerShell ISE -This topics in this document describe how you can use features of the Windows PowerShell® Integrated Scripting Environment (ISE) to be more productive. - -[How to Use Tab Completion in the Script Pane and Console Pane](How-to-Use-Tab-Completion-in-the-Script-Pane-and-Console-Pane.md) -Provides the steps to perform tab completion in both the Script Pane and the Console Pane. - -[How to Create a PowerShell Tab in Windows PowerShell ISE](How-to-Create-a-PowerShell-Tab-in-Windows-PowerShell-ISE.md) -Provides the steps to create a Windows PowerShell tab in Windows PowerShell ISE. - -[How to Use the Console Pane in the Windows PowerShell ISE](How-to-Use-the-Console-Pane-in-the-Windows-PowerShell-ISE.md) -Provides the steps for writing and running commands in the Console Pane. - -[How to Write and Run Scripts in the Windows PowerShell ISE](How-to-Write-and-Run-Scripts-in-the-Windows-PowerShell-ISE.md) -Provides the steps for writing and running scripts in the Script Pane. - -[How to Debug Scripts in Windows PowerShell ISE](How-to-Debug-Scripts-in-Windows-PowerShell-ISE.md) -Provides steps for debugging scripts in Windows PowerShell ISE - -[How to Use Profiles in Windows PowerShell ISE](How-to-Use-Profiles-in-Windows-PowerShell-ISE.md) -Provides information about and steps for creating and using profiles in Windows PowerShell ISE. - -## See Also -- [Exploring the Windows PowerShell ISE](../../getting-started/fundamental/Exploring-the-Windows-PowerShell-ISE.md) -- [Accessibility in Windows PowerShell ISE](../../setup/Accessibility-in-Windows-PowerShell-ISE.md) -- [The Windows PowerShell ISE Scripting Object Model](https://technet.microsoft.com/en-us/library/69b047d0-da79-413e-b948-8e45d05d1f85) - diff --git a/reference/docs-conceptual/core-powershell/ise/Windows-PowerShell-ISE-Object-Model-Reference.md b/reference/docs-conceptual/core-powershell/ise/Windows-PowerShell-ISE-Object-Model-Reference.md deleted file mode 100644 index 80ded7c81977..000000000000 --- a/reference/docs-conceptual/core-powershell/ise/Windows-PowerShell-ISE-Object-Model-Reference.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: Windows PowerShell ISE Object Model Reference -ms.assetid: e1a9e7d1-0fd5-47de-8d9b-f1be1ed13b0c ---- - -# Windows PowerShell ISE Object Model Reference - -## Object Model Reference - This section provides a reference on the underlying classes that define the various objects inWindows PowerShell® Integrated Scripting Environment (ISE). To see the objects organized in their hierarchy, see [The ISE Object Model Hierarchy](The-ISE-Object-Model-Hierarchy.md). - - [The ISEAddOnTool Object](The-ISEAddOnTool-Object.md) - Examples: $psISE.CurrentVisibleHorizontalTool, $psISE.CurrentVisibleVerticalTool. - - [The ISEAddOnTool Object](The-ISEAddOnTool-Object.md) - [The ISEEditor Object](The-ISEEditor-Object.md) - Examples: $psISE.CurrentFile.Editor, $psISE.CurrentPowerShellTab.Output, $psISE.CurrentPowerShellTab.CommandPane. - - [The ISEFile Object](The-ISEFile-Object.md) - Examples: $psISE.CurrentFile, $psISE.PowerShellTabs.Files\[0\]. - - [The ISEFileCollection Object](The-ISEFileCollection-Object.md) - Examples: $psISE.PowerShellTabs.Files. - - [The ISEMenuItem Object](The-ISEMenuItem-Object.md) - Examples: $psISE.CurrentPowerShellTab.AddOnsMenu , $psISE.CurrentPowerShellTab.AddOnsMenu.Submenus\[0\]. - - [The ISEMenuItemCollection Object](The-ISEMenuItemCollection-Object.md) - Example: $psISE.CurrentPowerShellTab.AddOnsMenu.Submenus. - - [The ISEOptions Object](The-ISEOptions-Object.md) - Examples: $psISE.Options, $psISE.Options.DefaultOptions. - - [The ObjectModelRoot Object](The-ObjectModelRoot-Object.md) - Example: The root $psISE object. - - [The PowerShellTab Object](The-PowerShellTab-Object.md) - Examples: $psISE.CurrentPowerShellTab, $psISE.PowerShellTabs\[0\]. - - [The PowerShellTabCollection Object](The-PowerShellTabCollection-Object.md) - Example: $psISE.PowerShellTabs. - -## See Also -- [The Windows PowerShell ISE Scripting Object Model](The-Windows-PowerShell-ISE-Scripting-Object-Model.md) diff --git a/reference/docs-conceptual/core-powershell/web-access.md b/reference/docs-conceptual/core-powershell/web-access.md deleted file mode 100644 index f7327c4f4118..000000000000 --- a/reference/docs-conceptual/core-powershell/web-access.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: web access ---- - -# Web Access for PowerShell - -- [Authorization rules and security features of windows powershell web access](web-access/authorization-rules-and-security-features-of-windows-powershell-web-access.md) -- [Install and use windows powershell web access](web-access/install-and-use-windows-powershell-web-access.md) -- [Troubleshooting access problems in windows powershell web access](web-access/troubleshooting-access-problems-in-windows-powershell-web-access.md) -- [Uninstall windows powershell web access](web-access/uninstall-windows-powershell-web-access.md) -- [Use the web based windows powershell console](web-access/use-the-web-based-windows-powershell-console.md) - diff --git a/reference/docs-conceptual/getting-started/basic-cookbooks.md b/reference/docs-conceptual/getting-started/basic-cookbooks.md deleted file mode 100644 index 9263b7a454ce..000000000000 --- a/reference/docs-conceptual/getting-started/basic-cookbooks.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: basic cookbooks ---- - -# [Basic Cookbooks Reference](cookbooks/basic-cookbooks-reference.md) - -- [Changing Computer State](cookbooks/Changing-Computer-State.md) -- [Collecting Information About Computers](cookbooks/Collecting-Information-About-Computers.md) -- [Compatibility Aliases](cookbooks/Appendix-1---Compatibility-Aliases.md) -- [Creating a Custom PowerShell Shortcut](cookbooks/Appendix-2---Creating-a-Custom-PowerShell-Shortcut.md) -- [Creating .NET and COM Objects New Object ](cookbooks/Creating-.NET-and-COM-Objects--New-Object-.md) -- [Creating a Custom Input Box](cookbooks/Creating-a-Custom-Input-Box.md) -- [Creating a Graphical Date Picker](cookbooks/Creating-a-Graphical-Date-Picker.md) -- [Getting WMI Objects Get WmiObject ](cookbooks/Getting-WMI-Objects--Get-WmiObject-.md) -- [Managing Current Location](cookbooks/Managing-Current-Location.md) -- [Managing Processes with Process Cmdlets](cookbooks/Managing-Processes-with-Process-Cmdlets.md) -- [Managing Services](cookbooks/Managing-Services.md) -- [Managing Windows PowerShell Drives](cookbooks/Managing-Windows-PowerShell-Drives.md) -- [Manipulating Items Directly](cookbooks/Manipulating-Items-Directly.md) -- [Multiple selection List Boxes](cookbooks/Multiple-selection-List-Boxes.md) -- [Other Useful Scripting Objects](cookbooks/Other-Useful-Scripting-Objects.md) -- [Performing Networking Tasks](cookbooks/Performing-Networking-Tasks.md) -- [Redirecting Data with Out Cmdlets](cookbooks/Redirecting-Data-with-Out---Cmdlets.md) -- [Removing Objects from the Pipeline Where Object ](cookbooks/Removing-Objects-from-the-Pipeline--Where-Object-.md) -- [Repeating a Task for Multiple Objects ForEach Object ](cookbooks/Repeating-a-Task-for-Multiple-Objects--ForEach-Object-.md) -- [Selecting Items from a List Box](cookbooks/Selecting-Items-from-a-List-Box.md) -- [Selecting Parts of Objects Select Object ](cookbooks/Selecting-Parts-of-Objects--Select-Object-.md) -- [Sorting Objects](cookbooks/Sorting-Objects.md) -- [Using Format Commands to Change Output View](cookbooks/Using-Format-Commands-to-Change-Output-View.md) -- [Using Static Classes and Methods](cookbooks/Using-Static-Classes-and-Methods.md) -- [Viewing Object Structure Get Member ](cookbooks/Viewing-Object-Structure--Get-Member-.md) -- [Working with Files and Folders](cookbooks/Working-with-Files-and-Folders.md) -- [Working With Files Folders and Registry Keys](cookbooks/Working-With-Files-Folders-and-Registry-Keys.md) -- [Working with Objects](cookbooks/Working-with-Objects.md) -- [Working with Printers](cookbooks/Working-with-Printers.md) -- [Working with Registry Entries](cookbooks/Working-with-Registry-Entries.md) -- [Working with Registry Keys](cookbooks/Working-with-Registry-Keys.md) -- [Working with Software Installations](cookbooks/Working-with-Software-Installations.md) - diff --git a/reference/docs-conceptual/getting-started/cookbooks/basic-cookbooks-reference.md b/reference/docs-conceptual/getting-started/cookbooks/basic-cookbooks-reference.md deleted file mode 100644 index 4db6908558e2..000000000000 --- a/reference/docs-conceptual/getting-started/cookbooks/basic-cookbooks-reference.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: basic cookbooks reference ---- - -# Basic Cookbooks Reference - -- [Changing Computer State](Changing-Computer-State.md) -- [Collecting Information About Computers](Collecting-Information-About-Computers.md) -- [Compatibility Aliases](Appendix-1---Compatibility-Aliases.md) -- [Creating .NET and COM Objects New Object ](Creating-.NET-and-COM-Objects--New-Object-.md) -- [Creating a Custom Input Box](Creating-a-Custom-Input-Box.md) -- [Creating a Custom PowerShell Shortcut](Appendix-2---Creating-a-Custom-PowerShell-Shortcut.md) -- [Creating a Graphical Date Picker](Creating-a-Graphical-Date-Picker.md) -- [Getting WMI Objects Get WmiObject ](Getting-WMI-Objects--Get-WmiObject-.md) -- [Managing Current Location](Managing-Current-Location.md) -- [Managing Processes with Process Cmdlets](Managing-Processes-with-Process-Cmdlets.md) -- [Managing Services](Managing-Services.md) -- [Managing Windows PowerShell Drives](Managing-Windows-PowerShell-Drives.md) -- [Manipulating Items Directly](Manipulating-Items-Directly.md) -- [Multiple selection List Boxes](Multiple-selection-List-Boxes.md) -- [Other Useful Scripting Objects](Other-Useful-Scripting-Objects.md) -- [Performing Networking Tasks](Performing-Networking-Tasks.md) -- [Redirecting Data with Out Cmdlets](Redirecting-Data-with-Out---Cmdlets.md) -- [Removing Objects from the Pipeline Where Object ](Removing-Objects-from-the-Pipeline--Where-Object-.md) -- [Repeating a Task for Multiple Objects ForEach Object ](Repeating-a-Task-for-Multiple-Objects--ForEach-Object-.md) -- [Selecting Items from a List Box](Selecting-Items-from-a-List-Box.md) -- [Selecting Parts of Objects Select Object ](Selecting-Parts-of-Objects--Select-Object-.md) -- [Sorting Objects](Sorting-Objects.md) -- [Using Format Commands to Change Output View](Using-Format-Commands-to-Change-Output-View.md) -- [Using Static Classes and Methods](Using-Static-Classes-and-Methods.md) -- [Viewing Object Structure Get Member ](Viewing-Object-Structure--Get-Member-.md) -- [Working with Files and Folders](Working-with-Files-and-Folders.md) -- [Working With Files Folders and Registry Keys](Working-With-Files-Folders-and-Registry-Keys.md) -- [Working with Objects](Working-with-Objects.md) -- [Working with Printers](Working-with-Printers.md) -- [Working with Registry Entries](Working-with-Registry-Entries.md) -- [Working with Registry Keys](Working-with-Registry-Keys.md) -- [Working with Software Installations](Working-with-Software-Installations.md) - diff --git a/reference/docs-conceptual/getting-started/fundamental-concepts.md b/reference/docs-conceptual/getting-started/fundamental-concepts.md deleted file mode 100644 index 248ff502d276..000000000000 --- a/reference/docs-conceptual/getting-started/fundamental-concepts.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: fundamental concepts ---- - -# Fundamental Concepts - -- [About Windows PowerShell](fundamental/About-Windows-PowerShell.md) -- [Exploring the Windows PowerShell ISE](fundamental/Exploring-the-Windows-PowerShell-ISE.md) -- [Getting Detailed Help Information](fundamental/Getting-Detailed-Help-Information.md) -- [Getting Information About Commands](fundamental/Getting-Information-About-Commands.md) -- [Learning Windows PowerShell Names](fundamental/Learning-Windows-PowerShell-Names.md) -- [Object Pipeline](fundamental/Object-Pipeline.md) -- [Scripting with Windows PowerShell](fundamental/Scripting-with-Windows-PowerShell.md) -- [Understanding Important Windows PowerShell Concepts](fundamental/Understanding-Important-Windows-PowerShell-Concepts.md) -- [Understanding the Windows PowerShell Pipeline](fundamental/Understanding-the-Windows-PowerShell-Pipeline.md) -- [Using Familiar Command Names](fundamental/Using-Familiar-Command-Names.md) -- [Using Variables to Store Objects](fundamental/Using-Variables-to-Store-Objects.md) -- [Using Windows PowerShell for Administration](fundamental/Using-Windows-PowerShell-for-Administration.md) -- [Using Windows PowerShell](fundamental/Using-Windows-PowerShell.md) -- [Windows PowerShell Basics](fundamental/Windows-PowerShell-Basics.md) -- [Windows PowerShell Integrated Scripting Environment ISE ](fundamental/Windows-PowerShell-Integrated-Scripting-Environment--ISE-.md) - diff --git a/reference/docs-conceptual/getting-started/fundamental/About-Windows-PowerShell.md b/reference/docs-conceptual/getting-started/fundamental/About-Windows-PowerShell.md deleted file mode 100644 index 52920eeac513..000000000000 --- a/reference/docs-conceptual/getting-started/fundamental/About-Windows-PowerShell.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: About Windows PowerShell -ms.assetid: 979654ae-7994-47f8-be43-d79e7a140143 ---- - -# About Windows PowerShell -Windows PowerShell is designed to improve the command-line and scripting environment by eliminating long-standing problems and adding new features. - -## Discoverability -Windows PowerShell makes it easy to discover its features. For example, to find a list of cmdlets that view and change Windows services, type: - -``` -Get-Command *-Service -``` - -After discovering which cmdlet accomplishes a task, you can learn more about the cmdlet by using the Get-Help cmdlet. For example, to display help about the Get-Service cmdlet, type: - -``` -Get-Help Get-Service -``` -Most cmdlets emit objects which can be manipulated and then rendered into text for display. To fully understand the output of that cmdlet, pipe its output to the Get-Member cmdlet. For example, the following command displays information about the members of the object output by the Get-Service cmdlet. - -``` -Get-Service | Get-Member -``` - -## Consistency -Managing systems can be a complex endeavor and tools that have a consistent interface help to control the inherent complexity. Unfortunately, neither command-line tools nor scriptable COM objects have been known for their consistency. - -The consistency of Windows PowerShell is one of its primary assets. For example, if you learn how to use the Sort-Object cmdlet, you can use that knowledge to sort the output of any cmdlet. You do not have to learn the different sorting routines of each cmdlet. - -In addition, cmdlet developers do not have to design sorting features for their cmdlets. Windows PowerShell gives them a framework that provides the basic features and forces them to be consistent about many aspects of the interface. The framework eliminates some of the choices that are typically left to the developer, but, in return, it makes the development of robust and easy-to-use cmdlets much simpler. - -## Interactive and Scripting Environments -Windows PowerShell is a combined interactive and scripting environment that gives you access to command-line tools and COM objects, and also enables you to use the power of the .NET Framework Class Library (FCL). - -This environment improves upon the Windows Command Prompt, which provides an interactive environment with multiple command-line tools. It also improves upon Windows Script Host (WSH) scripts, which let you use multiple command-line tools and COM automation objects, but do not provide an interactive environment. - -By combining access to all of these features, Windows PowerShell extends the ability of the interactive user and the script writer, and makes system administration more manageable. - -## Object Orientation -Although you interact with Windows PowerShell by typing commands in text, Windows PowerShell is based on objects, not text. The output of a command is an object. You can send the output object to another command as its input. As a result, Windows PowerShell provides a familiar interface to people experienced with other shells, while introducing a new and powerful command-line paradigm. It extends the concept of sending data between commands by enabling you to send objects, rather than text. - -## Easy Transition to Scripting -Windows PowerShell makes it easy to transition from typing commands interactively to creating and running scripts. You can type commands at the Windows PowerShell command prompt to discover the commands that perform a task. Then, you can save those commands in a transcript or a history before copying them to a file for use as a script. - diff --git a/reference/docs-conceptual/getting-started/fundamental/Using-Windows-PowerShell.md b/reference/docs-conceptual/getting-started/fundamental/Using-Windows-PowerShell.md deleted file mode 100644 index f7bf3a479f66..000000000000 --- a/reference/docs-conceptual/getting-started/fundamental/Using-Windows-PowerShell.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: Using Windows PowerShell -ms.assetid: cf06f1e5-3945-47e4-98be-412f5a1f43fe ---- - -# Using Windows PowerShell -Windows PowerShell® is a task-based command-line shell and scripting language designed especially for system administration. Built on the .NET Framework, Windows PowerShell helps IT professionals and power users control and automate the administration of the Windows operating system and applications that run on Windows. - -Resources in this section help you learn about Windows PowerShell, features that are included with Windows PowerShell, and the graphical Windows PowerShell editor, Windows PowerShell Integrated Scripting Environment. - -## What’s In This Section -Content in this section can help you learn more about Windows PowerShell, how to use Windows PowerShell, and what is new in Windows PowerShell in the most current releases. - -- [What's New in Windows PowerShell](../../whats-new/What-s-New-in-Windows-PowerShell-50.md). This topic describes changes to Windows PowerShell 3.0 and Windows PowerShell 4.0. - -- [Getting Started with Windows PowerShell](../Getting-Started-with-Windows-PowerShell.md). An introduction and tutorial, including system requirements and instructions for installing and starting Windows PowerShell on all supported operating systems. - -- [Windows PowerShell Integrated Scripting Environment (ISE)](Windows-PowerShell-Integrated-Scripting-Environment--ISE-.md). Documentation for Windows PowerShell ISE, a graphical Windows PowerShell script editor and console. - -- [Windows PowerShell Desired State Configuration (DSC) Overview](https://technet.microsoft.com/en-us/library/04c9e716-822c-40f0-8fdf-f2dda8abd888). An introduction to a new feature for Windows PowerShell 4.0, Windows PowerShell Desired State Configuration (DSC). DSC can help administrators achieve consistent configurations in Windows environments, and on devices such as network switches. - -- [PowerShell.exe Command-Line Help](../../core-powershell/console/PowerShell.exe-Command-Line-Help.md). How to start Windows PowerShell from the Windows Command Prompt, and run basic Windows PowerShell commands. - -- [Windows PowerShell Glossary](../../Windows-PowerShell-Glossary.md). Learn about common terms used in Windows PowerShell and its documentation. - -## Related Technologies -Windows PowerShell is part of a family of related scripting technologies that help you automate remote management of Windows-based computers. Links to more information about these technologies are included here for you. - -- [Windows PowerShell Workflow](http://technet.microsoft.com/library/jj134242.aspx). First introduced in Windows PowerShell 3.0, Windows PowerShell Workflow lets IT Pros and developers leverage the benefits of [Windows Workflow Foundation](http://msdn.microsoft.com/library/ee342461.aspx) with the automation capabilities and ease of Windows PowerShell. - -- [Windows PowerShell Web Access](http://technet.microsoft.com/library/hh831611.aspx). First introduced in Windows Server 2012, Windows PowerShell Web Access acts as a Windows PowerShell gateway, providing a web-based Windows PowerShell console that is targeted at a remote computer. It enables IT Pros to run Windows PowerShell commands and scripts from a Windows PowerShell console in a web browser, with no Windows PowerShell, remote management software, or browser plug-in installation necessary on the client device. - -- [Windows PowerShell Web Services (Management OData IIS Extension)](http://msdn.microsoft.com/library/windows/desktop/hh880865.aspx). Windows PowerShell Web Services is a framework for easily exposing Windows PowerShell cmdlets through an OData-based web service that is running in Web Server (IIS). - -- [Get Started with Windows PowerShell Desired State Configuration](https://technet.microsoft.com/en-us/library/c134aa32-b085-4656-9a89-955d8ff768d0). Windows PowerShell Desired State Configuration (DSC), introduced in Windows PowerShell 4.0, is a new management platform in Windows PowerShell that enables the deployment and management of configuration data for software services and the environment on which these services run. DSC provides a set of Windows PowerShell language extensions, new cmdlets, and resources that you can use to declaratively specify how you want the state of your software environment to be configured. - -- [Windows Management Framework 4.0 Preview](http://go.microsoft.com/fwlink/?LinkID=293881) includes updates to Windows PowerShell, Windows PowerShell ISE, Windows PowerShell Web Services (Management OData IIS Extension), Windows Remote Management (WinRM), Windows Management Infrastructure (WMI), the Server Manager WMI provider, and a new feature for 4.0, Windows PowerShell Desired State Configuration (DSC). Windows Management Framework 4.0 Preview allows you to install and use these technologies on computers that are running Windows Server 2012, Windows® 7 SP1, and Windows Server 2008 R2 SP1. - -- [Windows Management Framework 3.0](http://www.microsoft.com/download/details.aspx?id=34595) includes updates to Windows PowerShell, Windows PowerShell ISE, Windows PowerShell Web Services (Management OData IIS Extension), Windows Remote Management (WinRM), Windows Management Infrastructure (WMI), and the Server Manager WMI provider. Windows Management Framework 3.0 allows you to install and use these technologies on computers that are running Windows® 7 SP1, Windows Server 2008 SP2, and Windows Server 2008 R2 SP1. - -## Learning Windows PowerShell -To begin learning Windows PowerShell, start with the following resources: - -- [Microsoft Virtual Academy: Getting Started with PowerShell 3.0 Jump Start](https://mva.microsoft.com/en-us/training-courses/getting-started-with-powershell-3-0-jump-start-8276). This Jump Start is designed to teach busy IT professionals, admins, and help desk people how to use Windows PowerShell to improve management capabilities, automate redundant tasks, and manage the environment in scale. Learn how Windows PowerShellworks and how to make Windows PowerShell work for you from the experts Jeffrey Snover, the inventor of Windows PowerShell, and Jason Helmick, Senior Technologist at Concentrated Technology. - -- [Microsoft Virtual Academy: Advanced Tools & Scripting with PowerShell 3.0 Jump Start](https://mva.microsoft.com/en-US/training-courses/advanced-tools-scripting-with-powershell-30-jump-start-8277). IT pros, take this advanced Windows PowerShell course to find out how to turn your real time management and automation scripts into useful reusable tools and cmdlets. You’ll learn the best patterns and practices for building and maintaining tools and you’ll pick up some special tips and tricks along the way from the architect and inventor of Windows PowerShell, Distinguished Engineer Jeffrey Snover, and IT pro, Jason Helmick. - -- [Getting Started with Windows PowerShell](../Getting-Started-with-Windows-PowerShell.md). An introduction and tutorial, including system requirements and instructions for installing and starting Windows PowerShell on all supported operating systems. - -- [Windows PowerShell Core Module Reference](http://technet.microsoft.com/library/hh847741(v=wps.630).aspx). An alphabetized list of help topics for the language features and cmdlets included as part of the Windows PowerShell engine. - -- [Windows and Windows Server Automation with Windows PowerShell](http://technet.microsoft.com/library/dn249523.aspx). An alphabetized list of help topics for Windows PowerShell modules that are included as part of features or server roles included in Windows Server and Windows Client. - -- [System Center Automation with Windows PowerShell](https://technet.microsoft.com/en-us/library/mt156962.aspx). An alphabetized list of help topics for Windows PowerShell modules that are included with components of Microsoft System Center. - -## Downloading and Updating Windows PowerShell Help -The following topics describe how you can get the latest Help for Windows PowerShell and display it at the Windows PowerShell command prompt. - -- [Update-Help](http://technet.microsoft.com/library/hh849720.aspx) cmdlet. A Windows PowerShell cmdlet that downloads and installs the newest versions of help topics for Windows PowerShell modules on your computer. - - For more information about the Updatable Help system in Windows PowerShell, including how to install Updatable Help on network-isolated computers, see [about_Updatable_Help](http://technet.microsoft.com/library/hh847735.aspx), [Save-Help](http://technet.microsoft.com/library/hh849724.aspx), and [Supporting Updatable Help](http://msdn.microsoft.com/library/hh852754.aspx). - -- [Get-Help](http://technet.microsoft.com/library/hh849696(v=wps.630).aspx) cmdlet. A Windows PowerShell cmdlet that you can use to learn about the cmdlets and providers that are installed on your system. diff --git a/reference/docs-conceptual/getting-started/fundamental/Windows-PowerShell-Integrated-Scripting-Environment--ISE-.md b/reference/docs-conceptual/getting-started/fundamental/Windows-PowerShell-Integrated-Scripting-Environment--ISE-.md index fa8a43a45ed6..88a5eede4f5f 100644 --- a/reference/docs-conceptual/getting-started/fundamental/Windows-PowerShell-Integrated-Scripting-Environment--ISE-.md +++ b/reference/docs-conceptual/getting-started/fundamental/Windows-PowerShell-Integrated-Scripting-Environment--ISE-.md @@ -6,62 +6,97 @@ ms.assetid: f156b92d-0203-46d2-89c7-b4989d32e3d2 --- # Windows PowerShell Integrated Scripting Environment (ISE) -The Windows PowerShell Integrated Scripting Environment (ISE) is one of two hosts for the Windows PowerShell engine and language. With it you can write, run, and test scripts in ways that are not available in the Windows PowerShell Console. The ISE adds syntax-coloring, tab completion, IntelliSense, visual debugging, and context sensitive Help. -The ISE lets you run commands in a console pane, but it also supports panes that you can use to simultaneously view the source code of your script and other tools that can plug into the ISE. You can even open up multiple script windows at the same time, which is especially helpful when you are debugging a script that uses functions defined in other scripts or modules. +The Windows PowerShell Integrated Scripting Environment (ISE) is one of two hosts for the Windows +PowerShell engine and language. With it you can write, run, and test scripts in ways that are not +available in the Windows PowerShell Console. The ISE adds syntax-coloring, tab completion, +IntelliSense, visual debugging, and context sensitive Help. + +The ISE lets you run commands in a console pane, but it also supports panes that you can use to +simultaneously view the source code of your script and other tools that can plug into the ISE. You +can even open up multiple script windows at the same time, which is especially helpful when you are +debugging a script that uses functions defined in other scripts or modules. ## What’s New -Here are some of the features that have been added to the ISE in the most recent releases of PowerShell. + +Here are some of the features that have been added to the ISE in the most recent releases of +PowerShell. ### Added in PowerShell 3.0 (Windows Server 2012, Windows 8) -**IntelliSense** automatically completes your commands by displaying menus of matching cmdlets, parameters, parameter values, files, or folders as you type. -**Snippets** are short sections of code that you can easily insert into the scripts your write. A collection of useful snippets is included in the box and you can more by using the **New-Snippet** cmdlet. +**IntelliSense** automatically completes your commands by displaying menus of matching cmdlets, +parameters, parameter values, files, or folders as you type. + +**Snippets** are short sections of code that you can easily insert into the scripts your write. A +collection of useful snippets is included in the box and you can more by using the **New-Snippet** +cmdlet. -**Add-on tools** that add features to the ISE can be created by writing code that interacts with the [The Windows PowerShell ISE Scripting Object Model](../../core-powershell/ise/The-Windows-PowerShell-ISE-Scripting-Object-Model.md). These tools can display controls in a tabbed pane or work invisibly in the background. The **Commands** add-on is a good example and is included with version 3.0 and later that displays a list of the available commands and their Help. +**Add-on tools** that add features to the ISE can be created by writing code that interacts with +the [The Windows PowerShell ISE Scripting Object Model](../../core-powershell/ise/The-Windows-PowerShell-ISE-Scripting-Object-Model.md). +These tools can display controls in a tabbed pane or work invisibly in the background. The +**Commands** add-on is a good example and is included with version 3.0 and later that displays a +list of the available commands and their Help. -**Restart Manager and Auto-save** automatically save your scripts every two minutes to help you avoid the loss of your work in the event of a crash or unexpected restart. +**Restart Manager and Auto-save** automatically save your scripts every two minutes to help you +avoid the loss of your work in the event of a crash or unexpected restart. -**Most Recently Used list** is now part of the File Open menu to make it easier to get to the files you use most often. +**Most Recently Used list** is now part of the File Open menu to make it easier to get to the files +you use most often. -**Merged Console pane**. In previous versions of the ISE there were separate Command and Output panes. They are now combined into a single pane that more directly mimics what you see in the Windows Powershell Console. +**Merged Console pane**. In previous versions of the ISE there were separate Command and Output +panes. They are now combined into a single pane that more directly mimics what you see in the +Windows Powershell Console. -**Command-line switches**. Several new command-line switches give you more control over the way the ISE works. -NoProfile starts the ISE without running a profile script. -Help opens up a help window with the ISE. -mta starts the ISE in “multi-threaded apartment mode”. The default is single-threaded. +**Command-line switches**. Several new command-line switches give you more control over the way the +ISE works. -NoProfile starts the ISE without running a profile script. -Help opens up a help window +with the ISE. -mta starts the ISE in “multi-threaded apartment mode”. The default is +single-threaded. **New editor features** make it easier to create and read your code: -- **XML syntax coloring**. The ISE editor now colors XML syntax in the same way as it colors Windows PowerShell code syntax. +- **XML syntax coloring**. The ISE editor now colors XML syntax in the same way as it colors +Windows PowerShell code syntax. -- **Brace matching**. The ISEWindows PowerShell ISE highlights matching braces to help you ensure you have the right number of closing braces to match your opening ones. Use CTRL-\[ to locate the closing brace that matches the opening brace that the cursor is on. +- **Brace matching**. The ISEWindows PowerShell ISE highlights matching braces to help you ensure +you have the right number of closing braces to match your opening ones. Use CTRL-\[ to locate the +closing brace that matches the opening brace that the cursor is on. -- **Outline view**. You can collapse or expand sections of your code by clicking the plus and minus signs in the left margin. This makes it easier to find the code you’re looking for in a long script. +- **Outline view**. You can collapse or expand sections of your code by clicking the plus and minus +signs in the left margin. This makes it easier to find the code you’re looking for in a long +script. -- **Drag and drop text editing**. You can select a block of text and drag it to another location to move it. If you hold down the Ctrl key while you drag the selected text you copy instead of move. +- **Drag and drop text editing**. You can select a block of text and drag it to another location to +move it. If you hold down the Ctrl key while you drag the selected text you copy instead of move. -- **Parse error display**. Windows PowerShell examines your script as you type. If it detects an error, it shows a red squiggle under the offending code. When you hover over the indicated error, a tooltip shows you the problem that was found. +- **Parse error display**. Windows PowerShell examines your script as you type. If it detects an +error, it shows a red squiggle under the offending code. When you hover over the indicated error, a +tooltip shows you the problem that was found. -- **Zoom**. You can zoom in on your text to make it easier to read or zoom out to see the bigger picture by using the slider in the bottom-right corner of the ISE window. +- **Zoom**. You can zoom in on your text to make it easier to read or zoom out to see the bigger +picture by using the slider in the bottom-right corner of the ISE window. -- **Rich text copy and paste**. When you copy from the ISE to the clipboard, the font, size, and color information of the selected text is included. +- **Rich text copy and paste**. When you copy from the ISE to the clipboard, the font, size, and +color information of the selected text is included. -- **Block selection**. You can select a block-shaped chunk of text by holding down the ALT key while selecting text in the script pane with your mouse, or by pressing **Alt+Shift+Arrow**. +- **Block selection**. You can select a block-shaped chunk of text by holding down the ALT key +while selecting text in the script pane with your mouse, or by pressing **Alt+Shift+Arrow**. ### Added in PowerShell 2.0 (Windows Server 2008 R2, Windows 7) + The ISE was introduced with PowerShell v2.0. ## Requirements for running the Windows PowerShell ISE -The ISE is available on any Windows computer that can run Windows PowerShell -v2.0 or later. -Each version of Windows and Windows Server includes a version of Windows -PowerShell and the ISE, but you can upgrade to the latest available by -installing the Windows Management Framework. -Run this search to find the latest version available: -[Downloads](http://www.microsoft.com/en-us/search/DownloadResults.aspx?q=%22windows%20management%20framework%22%20PowerShell&sortby=Relevancy~Descending). -Note that any entries labelled "Preview" are pre-release code and are not feature complete. + +The ISE is available on any Windows computer that can run Windows PowerShell v2.0 or later. Each +version of Windows and Windows Server includes a version of Windows PowerShell and the ISE, but you +can upgrade to the latest available by installing the Windows Management Framework (WMF). See the +[WMF](/powershell/wmf/readme) documentation for more information. > [!NOTE] -> Because Windows PowerShell ISE requires a graphical user interface, you can’t run it on the Server Core option of Windows Server. +> Because Windows PowerShell ISE requires a graphical user interface, you can’t run it on the +> Server Core option of Windows Server. ## See also -- [Using the Windows PowerShell Integrated Scripting Environment](../../core-powershell/ise/Using-the-Windows-PowerShell-ISE.md) + +[Using the Windows PowerShell Integrated Scripting Environment](../../core-powershell/ise/Using-the-Windows-PowerShell-ISE.md) diff --git a/reference/docs-conceptual/setup/Starting-Windows-PowerShell-on-Earlier-Versions-of-Windows.md b/reference/docs-conceptual/setup/Starting-Windows-PowerShell-on-Earlier-Versions-of-Windows.md deleted file mode 100644 index bfddc0f2f65c..000000000000 --- a/reference/docs-conceptual/setup/Starting-Windows-PowerShell-on-Earlier-Versions-of-Windows.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: Starting Windows PowerShell on Earlier Versions of Windows -ms.assetid: 57125436-3d1e-4e7f-b5c4-8f0ecb49d642 ---- - -# Starting Windows PowerShell on Earlier Versions of Windows -This section explains how to start Windows PowerShell and Windows PowerShell Integrated Scripting Environment (ISE) on Windows® 7, Windows Server® 2008 R2, and Windows Server® 2008. It also explains how to enable the optional feature for Windows PowerShell ISE in Windows PowerShell 2.0 on Windows Server® 2008 R2 and Windows Server® 2008. - -To install Windows PowerShell 4.0 on supported systems, download and install [Windows Management Framework 4.0](http://go.microsoft.com/fwlink/?LinkID=293881). For more information, see [Installing Windows PowerShell](Installing-Windows-PowerShell.md). - -To install Windows PowerShell 3.0 on supported systems, download and install [Windows Management Framework 3.0](http://go.microsoft.com/fwlink/?LinkID=240290). For more information, see [Installing Windows PowerShell](Installing-Windows-PowerShell.md). - -## How to Start Windows PowerShell on Earlier Versions of Windows -Use any of the following methods to start the installed version of Windows PowerShell 3.0, or Windows PowerShell 4.0, where applicable. - -#### From the Start Menu - -- Click **Start**, type **PowerShell**, and then click **Windows PowerShell**. - -- From the **Start** menu, click **Start**, click **All Programs**, click **Accessories**, click the **Windows PowerShell** folder, and then click **Windows PowerShell**. - -#### At the Command Prompt - -- In Cmd.exe, Windows PowerShell, or Windows PowerShell ISE, to start Windows PowerShell, type: - - ``` - PowerShell - ``` - - You can also use the parameters of the PowerShell.exe program to customize the session. For more information, see [PowerShell.exe Command-Line Help](../core-powershell/console/PowerShell.exe-Command-Line-Help.md). - -#### With Administrative privileges ("Run as administrator") - -1. Click **Start**, type **PowerShell**, right-click **Windows PowerShell**, and then click **Run as administrator**. - -## How to Start Windows PowerShell ISE on Earlier Releases of Windows -Use any of the following methods to start Windows PowerShell ISE. - -#### From the Start Menu - -- Click **Start**, type **ISE**, and then click **Windows PowerShell ISE**. - -- From the **Start** menu, click **Start**, click **All Programs**, click **Accessories**, click the **Windows PowerShell** folder, and then click **Windows PowerShell ISE**. - -#### At the Command Prompt - -- In Cmd.exe, Windows PowerShell, or Windows PowerShell ISE, to start Windows PowerShell, type: - - ``` - PowerShell_ISE - ``` - - or - - ``` - ISE - ``` - -#### With Administrative privileges ("Run as administrator") - -1. Click **Start**, type **ISE**, right-click **Windows PowerShell ISE**, and then click **Run as administrator**. - -## How to Enable Windows PowerShell ISE on Earlier Releases of Windows -In Windows PowerShell 4.0 and Windows PowerShell 3.0, Windows PowerShell ISE is enabled by default on all versions of Windows. If it is not already enabled, Windows Management Framework 4.0 or Windows Management Framework 3.0 enables it. - -In Windows PowerShell 2.0, Windows PowerShell ISE is enabled by default on Windows 7. However, on Windows Server 2008 R2 and Windows Server 2008, it is an optional feature. - -To enable Windows PowerShell ISE in Windows PowerShell 2.0 on Windows Server 2008 R2 or Windows Server 2008, use the following procedure. - -#### To enable Windows PowerShell Integrated Scripting Environment (ISE) - -1. Start Server Manager. - -2. Click **Features** and then click **Add Features**. - -3. In Select Features, click Windows PowerShell Integrated Scripting Environment (ISE). - diff --git a/reference/docs-conceptual/setup/Starting-Windows-PowerShell.md b/reference/docs-conceptual/setup/Starting-Windows-PowerShell.md index 467d9fa22f4f..a365bb16b7d9 100644 --- a/reference/docs-conceptual/setup/Starting-Windows-PowerShell.md +++ b/reference/docs-conceptual/setup/Starting-Windows-PowerShell.md @@ -6,21 +6,139 @@ ms.assetid: 59b649a2-c90c-4cf4-bf95-a740c59148e7 --- # Starting Windows PowerShell -PowerShell is a scripting engine dll which is embedded into multiple hosts. The most common host you will start are the interactive command line PowerShell.exe and the Interactive Scripting Environment PowerShell_ISE.exe. +PowerShell is a scripting engine dll which is embedded into multiple hosts. The most common host you will start are the interactive command line PowerShell.exe and the Interactive Scripting Environment PowerShell_ISE.exe. To start Windows PowerShell® on Windows Server® 2012 R2, Windows® 8.1, Windows Server 2012, and Windows 8, see [Common Management Tasks and Navigation](http://technet.microsoft.com/library/hh831491.aspx). -The topics in this section explain how to start Windows PowerShell on older operating systems. +## How to Start Windows PowerShell on Earlier Versions of Windows -The topics include: +This section explains how to start Windows PowerShell and Windows PowerShell Integrated Scripting +Environment (ISE) on Windows® 7, Windows Server® 2008 R2, and Windows Server® 2008. It also +explains how to enable the optional feature for Windows PowerShell ISE in Windows PowerShell 2.0 on +Windows Server® 2008 R2 and Windows Server® 2008. -- [Starting Windows PowerShell on Earlier Versions of Windows](Starting-Windows-PowerShell-on-Earlier-Versions-of-Windows.md) +Use any of the following methods to start the installed version of Windows PowerShell 3.0, or +Windows PowerShell 4.0, where applicable. -- [Starting the 32-Bit Version of Windows PowerShell](Starting-the-32-Bit-Version-of-Windows-PowerShell.md) +#### From the Start Menu -- [Starting the Windows PowerShell 2.0 Engine](Starting-the-Windows-PowerShell-2.0-Engine.md) +- Click **Start**, type **PowerShell**, and then click **Windows PowerShell**. +- From the **Start** menu, click **Start**, click **All Programs**, click **Accessories**, click + the **Windows PowerShell** folder, and then click **Windows PowerShell**. -## See Also -- [Windows PowerShell System Requirements](Windows-PowerShell-System-Requirements.md) -- [Installing Windows PowerShell](Installing-Windows-PowerShell.md) +#### At the Command Prompt +In Cmd.exe, Windows PowerShell, or Windows PowerShell ISE, to start Windows PowerShell, type: + +``` +PowerShell +``` + +You can also use the parameters of the PowerShell.exe program to customize the session. For more +information, see [PowerShell.exe Command-Line Help](../core-powershell/console/PowerShell.exe-Command-Line-Help.md). + +#### With Administrative privileges ("Run as administrator") + +Click **Start**, type **PowerShell**, right-click **Windows PowerShell**, and then click **Run as +administrator**. + +## How to Start Windows PowerShell ISE on Earlier Releases of Windows + +Use any of the following methods to start Windows PowerShell ISE. + +#### From the Start Menu + +- Click **Start**, type **ISE**, and then click **Windows PowerShell ISE**. +- From the **Start** menu, click **Start**, click **All Programs**, click **Accessories**, click + the **Windows PowerShell** folder, and then click **Windows PowerShell ISE**. + +#### At the Command Prompt + +In Cmd.exe, Windows PowerShell, or Windows PowerShell ISE, to start Windows PowerShell, type: + +``` +PowerShell_ISE +``` + +or + +``` +ISE +``` + +#### With Administrative privileges ("Run as administrator") + +Click **Start**, type **ISE**, right-click **Windows PowerShell ISE**, and then click **Run as +administrator**. + +## How to Enable Windows PowerShell ISE on Earlier Releases of Windows + +In Windows PowerShell 4.0 and Windows PowerShell 3.0, Windows PowerShell ISE is enabled by default +on all versions of Windows. If it is not already enabled, Windows Management Framework 4.0 or +Windows Management Framework 3.0 enables it. + +In Windows PowerShell 2.0, Windows PowerShell ISE is enabled by default on Windows 7. However, on +Windows Server 2008 R2 and Windows Server 2008, it is an optional feature. + +To enable Windows PowerShell ISE in Windows PowerShell 2.0 on Windows Server 2008 R2 or Windows +Server 2008, use the following procedure. + +#### To enable Windows PowerShell Integrated Scripting Environment (ISE) + +1. Start Server Manager. +2. Click **Features** and then click **Add Features**. +3. In Select Features, click Windows PowerShell Integrated Scripting Environment (ISE). + +## Starting the 32-Bit Version of Windows PowerShell + +When you install Windows PowerShell on a 64-bit computer, **Windows PowerShell (x86)**, a 32-bit +version of Windows PowerShell is installed in addition to the 64-bit version. When you run Windows +PowerShell, the 64-bit version runs by default. + +However, you might occasionally need to run **Windows PowerShell (x86)**, such as when you are +using a module that requires the 32-bit version or when you are connecting remotely to a 32-bit +computer. + +To start a 32-bit version of Windows PowerShell, use any of the following procedures. + +#### In Windows Server® 2012 R2 + +- On the **Start** screen, type **Windows PowerShell (x86)**. Click the **Windows PowerShell x86** + tile. +- In **Server Manager**, from the **Tools** menu, select **Windows PowerShell (x86)**. +- On the desktop, move the cursor to the upper right corner, click **Search**, type **PowerShell + x86** and then click **Windows PowerShell (x86)**. +- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` + +#### In Windows Server® 2012 + +- On the **Start** screen, type **PowerShell** and then click **Windows PowerShell (x86)**. +- In **Server Manager**, from the **Tools** menu, select **Windows PowerShell (x86)**. +- On the desktop, move the cursor to the upper right corner, click **Search**, type **PowerShell** + and then click **Windows PowerShell (x86)**. +- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` + +#### In Windows® 8.1 + +- On the **Start** screen, type **Windows PowerShell (x86)**. Click the **Windows PowerShell x86** + tile. +- If you are running + [Remote Server Administration Tools](http://go.microsoft.com/fwlink/?LinkID=304145) for + Windows 8.1, you can also open Windows PowerShell x86 from the **Server ManagerTools** menu. + Select **Windows PowerShell (x86)**. +- On the desktop, move the cursor to the upper right corner, click **Search**, type **PowerShell + x86** and then click **Windows PowerShell (x86)**. +- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` + +#### In Windows® 8 + +- On the **Start** screen, move the cursor to the upper right corner, click **Settings**, click + **Tiles**, and then move the **Show Administrative Tools** slider to Yes. Then, type **PowerShell** + and click **Windows PowerShell (x86)**. +- If you are running + [Remote Server Administration Tools](http://www.microsoft.com/download/details.aspx?id=28972) for + Windows 8, you can also open Windows PowerShell x86 from the **Server ManagerTools** menu. Select + **Windows PowerShell (x86)**. +- On the **Start** screen or the desktop, type **PowerShell (x86)** and then click **Windows + PowerShell (x86)**. +- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` diff --git a/reference/docs-conceptual/setup/Starting-the-32-Bit-Version-of-Windows-PowerShell.md b/reference/docs-conceptual/setup/Starting-the-32-Bit-Version-of-Windows-PowerShell.md deleted file mode 100644 index 136fc9da4433..000000000000 --- a/reference/docs-conceptual/setup/Starting-the-32-Bit-Version-of-Windows-PowerShell.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: Starting the 32 Bit Version of Windows PowerShell -ms.assetid: 12b31890-2609-4a76-8c24-0ebe78084f50 ---- - -# Starting the 32-Bit Version of Windows PowerShell -When you install Windows PowerShell on a 64-bit computer, **Windows PowerShell (x86)**, a 32-bit version of Windows PowerShell is installed in addition to the 64-bit version. When you run Windows PowerShell, the 64-bit version runs by default. - -However, you might occasionally need to run **Windows PowerShell (x86)**, such as when you are using a module that requires the 32-bit version or when you are connecting remotely to a 32-bit computer. - -To start a 32-bit version of Windows PowerShell, use any of the following procedures. - -#### In Windows Server® 2012 R2 - -- On the **Start** screen, type **Windows PowerShell (x86)**. Click the **Windows PowerShell x86** tile. - -- In **Server Manager**, from the **Tools** menu, select **Windows PowerShell (x86)**. - -- On the desktop, move the cursor to the upper right corner, click **Search**, type **PowerShell x86** and then click **Windows PowerShell (x86)**. - -- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` - -#### In Windows Server® 2012 - -- On the **Start** screen, type **PowerShell** and then click **Windows PowerShell (x86)**. - -- In **Server Manager**, from the **Tools** menu, select **Windows PowerShell (x86)**. - -- On the desktop, move the cursor to the upper right corner, click **Search**, type **PowerShell** and then click **Windows PowerShell (x86)**. - -- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` - -#### In Windows® 8.1 - -- On the **Start** screen, type **Windows PowerShell (x86)**. Click the **Windows PowerShell x86** tile. - -- If you are running [Remote Server Administration Tools](http://go.microsoft.com/fwlink/?LinkID=304145) for Windows 8.1, you can also open Windows PowerShell x86 from the **Server ManagerTools** menu. Select **Windows PowerShell (x86)**. - -- On the desktop, move the cursor to the upper right corner, click **Search**, type **PowerShell x86** and then click **Windows PowerShell (x86)**. - -- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` - -#### In Windows® 8 - -- On the **Start** screen, move the cursor to the upper right corner, click **Settings**, click **Tiles**, and then move the **Show Administrative Tools** slider to Yes. Then, type **PowerShell** and click **Windows PowerShell (x86)**. - -- If you are running [Remote Server Administration Tools](http://www.microsoft.com/download/details.aspx?id=28972) for Windows 8, you can also open Windows PowerShell x86 from the **Server ManagerTools** menu. Select **Windows PowerShell (x86)**. - -- On the **Start** screen or the desktop, type **PowerShell (x86)** and then click **Windows PowerShell (x86)**. - -- Via command line, enter: `%SystemRoot%\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` - diff --git a/reference/docs-conceptual/setup/Starting-the-Windows-PowerShell-2.0-Engine.md b/reference/docs-conceptual/setup/Starting-the-Windows-PowerShell-2.0-Engine.md index 7db4773e454a..5bf0891cbfb6 100644 --- a/reference/docs-conceptual/setup/Starting-the-Windows-PowerShell-2.0-Engine.md +++ b/reference/docs-conceptual/setup/Starting-the-Windows-PowerShell-2.0-Engine.md @@ -6,61 +6,114 @@ ms.assetid: edafc2fa-7576-49c2-bbba-9336f4bcfc28 --- # Starting the Windows PowerShell 2.0 Engine -This section explains how to start the Windows PowerShell 2.0 Engine on Windows 8.1, Windows Server 2012 R2, Windows 8, and Windows Server 2012, which include the Windows PowerShell 2.0 Engine, and on other systems on which Windows PowerShell 2.0, Windows PowerShell 3.0, and Windows PowerShell 4.0 are installed. -Windows PowerShell 4.0 and Windows PowerShell 3.0 are designed to be backwards compatible with Windows PowerShell 2.0. Cmdlets, providers, snap-ins, modules, and scripts written for Windows PowerShell 2.0 run unchanged in Windows PowerShell 4.0 and Windows PowerShell 3.0. However, due to a change in the runtime activation policy in Microsoft .NET Framework 4, Windows PowerShell host programs that were written for Windows PowerShell 2.0 and compiled with Common Language Runtime (CLR) 2.0 cannot run without modification in Windows PowerShell 3.0 or Windows PowerShell 4.0, which are compiled with CLR 4.0. The Windows PowerShell 2.0 Engine is intended to be used only when an existing script or host program cannot run because it is incompatible with Windows PowerShell 4.0, Windows PowerShell 3.0, or Microsoft .NET Framework 4. Such cases are expected to be rare. +This section explains how to start the Windows PowerShell 2.0 Engine on Windows 8.1, Windows Server +2012 R2, Windows 8, and Windows Server 2012, which include the Windows PowerShell 2.0 Engine, and +on other systems on which Windows PowerShell 2.0, Windows PowerShell 3.0, and Windows PowerShell +4.0 are installed. -Many programs that require the Windows PowerShell 2.0 Engine start it automatically. These instructions are included for the rare situations in which you need to start the engine manually. +Windows PowerShell 4.0 and Windows PowerShell 3.0 are designed to be backwards compatible with +Windows PowerShell 2.0. Cmdlets, providers, snap-ins, modules, and scripts written for Windows +PowerShell 2.0 run unchanged in Windows PowerShell 4.0 and Windows PowerShell 3.0. However, due to +a change in the runtime activation policy in Microsoft .NET Framework 4, Windows PowerShell host +programs that were written for Windows PowerShell 2.0 and compiled with Common Language Runtime +(CLR) 2.0 cannot run without modification in Windows PowerShell 3.0 or Windows PowerShell 4.0, +which are compiled with CLR 4.0. The Windows PowerShell 2.0 Engine is intended to be used only when +an existing script or host program cannot run because it is incompatible with Windows PowerShell +4.0, Windows PowerShell 3.0, or Microsoft .NET Framework 4. Such cases are expected to be rare. + +Many programs that require the Windows PowerShell 2.0 Engine start it automatically. These +instructions are included for the rare situations in which you need to start the engine manually. ## Installing and Enabling Required Programs -Before starting the Windows PowerShell 2.0 Engine, enable the Windows PowerShell 2.0 Engine and Microsoft .NET Framework 3.5 with Service Pack 1. For instructions, see [Installing Windows PowerShell](Installing-Windows-PowerShell.md). -Systems on which [Windows Management Framework 4.0](http://go.microsoft.com/fwlink/?LinkID=293881) or Windows Management Framework 3.0 are installed have all of the required components. No further configuration is necessary. For information about installing [Windows Management Framework 4.0](http://go.microsoft.com/fwlink/?LinkID=293881) or Windows Management Framework 3.0, see [Installing Windows PowerShell](Installing-Windows-PowerShell.md). +Before starting the Windows PowerShell 2.0 Engine, enable the Windows PowerShell 2.0 Engine and +Microsoft .NET Framework 3.5 with Service Pack 1. For instructions, see +[Installing Windows PowerShell](Installing-Windows-PowerShell.md). + +Systems on which [Windows Management Framework 4.0](http://go.microsoft.com/fwlink/?LinkID=293881) +or Windows Management Framework 3.0 are installed have all of the required components. No further +configuration is necessary. For information about installing [Windows Management Framework +4.0](http://go.microsoft.com/fwlink/?LinkID=293881) or Windows Management Framework 3.0, see +[Installing Windows PowerShell](Installing-Windows-PowerShell.md). ## How to start the Windows PowerShell 2.0 Engine -When you start Windows PowerShell the newest version starts by default. To start Windows PowerShell with the Windows PowerShell 2.0 Engine, use the Version parameter of PowerShell.exe. You can run the command at any command prompt, including Windows PowerShell and Cmd.exe. + +When you start Windows PowerShell the newest version starts by default. To start Windows PowerShell +with the Windows PowerShell 2.0 Engine, use the Version parameter of PowerShell.exe. You can run +the command at any command prompt, including Windows PowerShell and Cmd.exe. ``` PowerShell.exe -Version 2 ``` ## How to start a remote session with the Windows PowerShell 2.0 Engine -To run the Windows PowerShell 2.0 Engine in a remote session, create a session configuration (also known as an "endpoint") on the remote computer that loads the Windows PowerShell 2.0 Engine. The session configuration is saved on the remote computer and can be used by any authorized user to create sessions that use the Windows PowerShell 2.0 Engine. -This is an advanced task that is typically performed by a system administrator. +To run the Windows PowerShell 2.0 Engine in a remote session, create a session configuration (also +known as an "endpoint") on the remote computer that loads the Windows PowerShell 2.0 Engine. The +session configuration is saved on the remote computer and can be used by any authorized user to +create sessions that use the Windows PowerShell 2.0 Engine. -The following procedure uses the **PSVersion** parameter of the [Register-PSSessionConfiguration](https://technet.microsoft.com/en-us/library/e9152ae2-bd6d-4056-9bc7-dc1893aa29ea) cmdlet to create a session configuration that uses the Windows PowerShell 2.0 Engine. You can also use the **PowerShellVersion** parameter of the [New-PSSessionConfigurationFile](https://technet.microsoft.com/en-us/library/5f3e3633-6e90-479c-aea9-ba45a1954866) cmdlet to create a session configuration file for a session that loads the Windows PowerShell 2.0 Engine and you can use the **PSVersion** parameter of the [Set-PSSessionConfiguration](https://technet.microsoft.com/en-us/library/b21fbad3-1759-4260-b206-dcb8431cd6ea) parameter to change a session configuration to use the Windows PowerShell 2.0 Engine. +This is an advanced task that is typically performed by a system administrator. -For more information about session configuration files, see [about_Session_Configuration_Files](https://technet.microsoft.com/en-us/library/c7217447-1ebf-477b-a8ef-4dbe9a1473b8).For information about session configurations, including setup and security, see [about_Session_Configurations [v4]](https://technet.microsoft.com/en-us/library/a2fbe12a-350c-4d04-be50-24102824e3ab). +The following procedure uses the **PSVersion** parameter of the +[Register-PSSessionConfiguration](https://technet.microsoft.com/en-us/library/e9152ae2-bd6d-4056-9bc7-dc1893aa29ea) +cmdlet to create a session configuration that uses the Windows PowerShell 2.0 Engine. You can also +use the **PowerShellVersion** parameter of the +[New-PSSessionConfigurationFile](https://technet.microsoft.com/en-us/library/5f3e3633-6e90-479c-aea9-ba45a1954866) +cmdlet to create a session configuration file for a session that loads the Windows PowerShell 2.0 +Engine and you can use the **PSVersion** parameter of the +[Set-PSSessionConfiguration](https://technet.microsoft.com/en-us/library/b21fbad3-1759-4260-b206-dcb8431cd6ea) +parameter to change a session configuration to use the Windows PowerShell 2.0 Engine. + +For more information about session configuration files, see +[about_Session_Configuration_Files](https://technet.microsoft.com/en-us/library/c7217447-1ebf-477b-a8ef-4dbe9a1473b8).For +information about session configurations, including setup and security, see +[about_Session_Configurations[v4]](https://technet.microsoft.com/en-us/library/a2fbe12a-350c-4d04-be50-24102824e3ab). #### To start a remote Windows PowerShell 2.0 session -1. To create a session configuration that requires the Windows PowerShell 2.0 Engine, use the **PSVersion** parameter of the [Register-PSSessionConfiguration](https://technet.microsoft.com/en-us/library/e9152ae2-bd6d-4056-9bc7-dc1893aa29ea) cmdlet with a value of "2.0". Run this command on the computer at the "server side" or receiving end of the connection. +1. To create a session configuration that requires the Windows PowerShell 2.0 Engine, use the + **PSVersion** parameter of the + [Register-PSSessionConfiguration](https://technet.microsoft.com/en-us/library/e9152ae2-bd6d-4056-9bc7-dc1893aa29ea) + cmdlet with a value of "2.0". Run this command on the computer at the "server side" or receiving + end of the connection. - The following sample command creates the PS2 session configuration on the Server01 computer. To run this command, start Windows PowerShell 4.0 or Windows PowerShell 3.0 with the **Run as administrator** option. + The following sample command creates the PS2 session configuration on the Server01 computer. To + run this command, start Windows PowerShell 4.0 or Windows PowerShell 3.0 with the **Run as + administrator** option. - ``` - Register-PSSessionConfiguration -Name PS2 -PSVersion 2.0 - ``` + ```powershell + Register-PSSessionConfiguration -Name PS2 -PSVersion 2.0 + ``` -2. To create a session on the Server01 computer that uses the PS2 session configuration, use the **ConfigurationName** parameter of cmdlets that create a remote session, such as the [New-PSSession](https://technet.microsoft.com/en-us/library/76f6628c-054c-4eda-ba7a-a6f28daaa26f) cmdlet. +2. To create a session on the Server01 computer that uses the PS2 session configuration, use the + **ConfigurationName** parameter of cmdlets that create a remote session, such as the + [New-PSSession](https://technet.microsoft.com/en-us/library/76f6628c-054c-4eda-ba7a-a6f28daaa26f) + cmdlet. - When a session that uses the session configuration starts, the Windows PowerShell 2.0 Engine is automatically loaded into the session. + When a session that uses the session configuration starts, the Windows PowerShell 2.0 Engine is + automatically loaded into the session. - The following command starts a session on the Server01 computer that uses the PS2 session configuration. The command saves the session in the $s variable. + The following command starts a session on the Server01 computer that uses the PS2 session + configuration. The command saves the session in the $s variable. - ``` - $s = New-PSSession -ComputerName Server01 -ConfigurationName PS2 - ``` + ```powershell + $s = New-PSSession -ComputerName Server01 -ConfigurationName PS2 + ``` ## How to start a background job with the Windows PowerShell 2.0 Engine -To start a background job with the Windows PowerShell 2.0 Engine, use the **PSVersion** parameter of the [Start-Job](https://technet.microsoft.com/en-us/library/2bc04935-0deb-4ec0-b856-d7290cca6442) cmdlet. + +To start a background job with the Windows PowerShell 2.0 Engine, use the **PSVersion** parameter +of the +[Start-Job](https://technet.microsoft.com/en-us/library/2bc04935-0deb-4ec0-b856-d7290cca6442) +cmdlet. The following command starts a background job with the Windows PowerShell 2.0 Engine -``` +```powershell Start-Job {Get-Process} -PSVersion 2.0 ``` -For more information about background jobs, see [about_Jobs [v4]](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_jobs?view=powershell-4.0). - +For more information about background jobs, see +[about_Jobs](/powershell/module/microsoft.powershell.core/about/about_jobs). diff --git a/reference/docs-conceptual/setup/setup-reference.md b/reference/docs-conceptual/setup/setup-reference.md deleted file mode 100644 index aeb967904927..000000000000 --- a/reference/docs-conceptual/setup/setup-reference.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -ms.date: 2017-06-05 -keywords: powershell,cmdlet -title: setup reference ---- - -# Setup Guide - -- [Installing PowerShell Core on macOS and Linux](Installing-PowerShell-Core-on-macOS-and-Linux.md) -- [Installing PowerShell Core on Windows](Installing-PowerShell-Core-on-Windows.md) -- [Installing Windows PowerShell](Installing-Windows-PowerShell.md) -- [Installing the Windows PowerShell 2.0 Engine](Installing-the-Windows-PowerShell-2.0-Engine.md) -- [Installing the Windows PowerShell SDK](Installing-the-Windows-PowerShell-SDK.md) -- [Setup Reference](setup-reference.md) -- [Accessibility in Windows PowerShell ISE](Accessibility-in-Windows-PowerShell-ISE.md) -- [Starting the 32 Bit Version of Windows PowerShell](Starting-the-32-Bit-Version-of-Windows-PowerShell.md) -- [Starting the Windows PowerShell 2.0 Engine](Starting-the-Windows-PowerShell-2.0-Engine.md) -- [Starting Windows PowerShell on Earlier Versions of Windows](Starting-Windows-PowerShell-on-Earlier-Versions-of-Windows.md) -- [Starting Windows PowerShell](Starting-Windows-PowerShell.md) -- [Windows PowerShell System Requirements](Windows-PowerShell-System-Requirements.md) -- [WinRMSecurity](WinRMSecurity.md) diff --git a/reference/docs-conceptual/toc.yml b/reference/docs-conceptual/toc.yml index 95cefcc2907e..d87713a4e833 100644 --- a/reference/docs-conceptual/toc.yml +++ b/reference/docs-conceptual/toc.yml @@ -1,8 +1,66 @@ -- name: Conceptual +- name: Overview href: PowerShell-Scripting.md items: - - name: Core PowerShell - href: core-powershell/core-powershell.md + - name: Install + href: '' + items: + - name: PowerShell Core + href: '' + items: + - name: Installing PowerShell Core on Windows + href: setup/Installing-PowerShell-Core-on-Windows.md + - name: Installing PowerShell Core on macOS and Linux + href: setup/Installing-PowerShell-Core-on-macOS-and-Linux.md + - name: Windows PowerShell + href: '' + items: + - name: Installing Windows PowerShell + href: setup/installing-windows-powershell.md + - name: Installing the Windows PowerShell 2.0 Engine + href: setup/installing-the-windows-powershell-2.0-engine.md + - name: Windows PowerShell System Requirements + href: setup/windows-powershell-system-requirements.md + - name: Get started + href: getting-started/getting-started-with-windows-powershell.md + items: + - name: Starting Windows PowerShell + href: setup/starting-windows-powershell.md + - name: Starting the Windows PowerShell 2.0 Engine + href: setup/starting-the-windows-powershell-2.0-engine.md + - name: Concepts + href: '' + items: + - name: Understanding Important Windows PowerShell Concepts + href: getting-started/fundamental/understanding-important-windows-powershell-concepts.md + - name: Getting Detailed Help Information + href: getting-started/fundamental/getting-detailed-help-information.md + - name: Getting Information About Commands + href: getting-started/fundamental/getting-information-about-commands.md + - name: Learning Windows PowerShell Names + href: getting-started/fundamental/learning-windows-powershell-names.md + - name: Using Familiar Command Names + href: getting-started/fundamental/using-familiar-command-names.md + - name: Object Pipeline + href: getting-started/fundamental/object-pipeline.md + - name: Scripting with Windows PowerShell + href: getting-started/fundamental/scripting-with-windows-powershell.md + - name: Understanding the Windows PowerShell Pipeline + href: getting-started/fundamental/understanding-the-windows-powershell-pipeline.md + - name: Using Variables to Store Objects + href: getting-started/fundamental/using-variables-to-store-objects.md + - name: Running Remote Commands + href: core-powershell/running-remote-commands.md + items: + - name: PowerShell Remoting Over SSH + href: core-powershell/SSH-Remoting-in-PowerShell-Core.md + - name: WS-Management (WSMan) Remoting in PowerShell Core + href: core-powershell/WSMan-Remoting-in-PowerShell-Core.md + - name: WinRMSecurity + href: setup/winrmsecurity.md + - name: PS remoting second hop + href: setup/ps-remoting-second-hop.md + - name: Components + href: '' items: - name: Console href: '' @@ -14,73 +72,68 @@ - name: ISE href: core-powershell/ise/introducing-the-windows-powershell-ise.md items: - - name: How to Create a PowerShell Tab in Windows PowerShell ISE - href: core-powershell/ise/how-to-create-a-powershell-tab-in-windows-powershell-ise.md - - name: How to Debug Scripts in Windows PowerShell ISE - href: core-powershell/ise/how-to-debug-scripts-in-windows-powershell-ise.md - - name: How to Use Profiles in Windows PowerShell ISE - href: core-powershell/ise/how-to-use-profiles-in-windows-powershell-ise.md - - name: How to Use Tab Completion in the Script Pane and Console Pane - href: core-powershell/ise/how-to-use-tab-completion-in-the-script-pane-and-console-pane.md - - name: How to Use the Console Pane in the Windows PowerShell ISE - href: core-powershell/ise/how-to-use-the-console-pane-in-the-windows-powershell-ise.md - - name: How to Write and Run Scripts in the Windows PowerShell ISE - href: core-powershell/ise/how-to-write-and-run-scripts-in-the-windows-powershell-ise.md - - name: Introducing the Windows PowerShell ISE - href: core-powershell/ise/introducing-the-windows-powershell-ise.md - - name: ISE Module - href: core-powershell/ise/ise-module.md - - name: Keyboard Shortcuts for the Windows PowerShell ISE - href: core-powershell/ise/keyboard-shortcuts-for-the-windows-powershell-ise.md - - name: Purpose of the Windows PowerShell ISE Scripting Object Model - href: core-powershell/ise/purpose-of-the-windows-powershell-ise-scripting-object-model.md - - name: The ISEAddOnToolCollection Object - href: core-powershell/ise/the-iseaddontoolcollection-object.md - - name: The ISEAddOnTool Object - href: core-powershell/ise/the-iseaddontool-object.md - - name: The ISEEditor Object - href: core-powershell/ise/the-iseeditor-object.md - - name: The ISEFileCollection Object - href: core-powershell/ise/the-isefilecollection-object.md - - name: The ISEFile Object - href: core-powershell/ise/the-isefile-object.md - - name: The ISEMenuItemCollection Object - href: core-powershell/ise/the-isemenuitemcollection-object.md - - name: The ISEMenuItem Object - href: core-powershell/ise/the-isemenuitem-object.md - - name: The ISE Object Model Hierarchy - href: core-powershell/ise/the-ise-object-model-hierarchy.md - - name: The ISEOptions Object - href: core-powershell/ise/the-iseoptions-object.md - - name: The ISESnippetCollection Object - href: core-powershell/ise/the-isesnippetcollection-object.md - - name: The ISESnippetObject - href: core-powershell/ise/the-isesnippetobject.md - - name: The ObjectModelRoot Object - href: core-powershell/ise/the-objectmodelroot-object.md - - name: The PowerShellTabCollection Object - href: core-powershell/ise/the-powershelltabcollection-object.md - - name: The PowerShellTab Object - href: core-powershell/ise/the-powershelltab-object.md - - name: The Windows PowerShell ISE Scripting Object Model - href: core-powershell/ise/the-windows-powershell-ise-scripting-object-model.md + - name: Windows PowerShell Integrated Scripting Environment (ISE) + href: getting-started/fundamental/windows-powershell-integrated-scripting-environment--ise-.md - name: Using the Windows PowerShell ISE - href: core-powershell/ise/using-the-windows-powershell-ise.md - - name: Windows PowerShell ISE Object Model Reference - href: core-powershell/ise/windows-powershell-ise-object-model-reference.md + href: '' + items: + - name: Exploring the Windows PowerShell ISE + href: getting-started/fundamental/exploring-the-windows-powershell-ise.md + - name: How to Create a PowerShell Tab in Windows PowerShell ISE + href: core-powershell/ise/how-to-create-a-powershell-tab-in-windows-powershell-ise.md + - name: How to Debug Scripts in Windows PowerShell ISE + href: core-powershell/ise/how-to-debug-scripts-in-windows-powershell-ise.md + - name: How to Use Profiles in Windows PowerShell ISE + href: core-powershell/ise/how-to-use-profiles-in-windows-powershell-ise.md + - name: How to Use Tab Completion in the Script Pane and Console Pane + href: core-powershell/ise/how-to-use-tab-completion-in-the-script-pane-and-console-pane.md + - name: How to Use the Console Pane in the Windows PowerShell ISE + href: core-powershell/ise/how-to-use-the-console-pane-in-the-windows-powershell-ise.md + - name: How to Write and Run Scripts in the Windows PowerShell ISE + href: core-powershell/ise/how-to-write-and-run-scripts-in-the-windows-powershell-ise.md + - name: Keyboard Shortcuts for the Windows PowerShell ISE + href: core-powershell/ise/keyboard-shortcuts-for-the-windows-powershell-ise.md + - name: Accessibility in Windows PowerShell ISE + href: setup/accessibility-in-windows-powershell-ise.md + - name: The Windows PowerShell ISE Scripting Object Model + href: '' + items: + - name: Purpose of the Windows PowerShell ISE Scripting Object Model + href: core-powershell/ise/purpose-of-the-windows-powershell-ise-scripting-object-model.md + - name: The ISE Object Model Hierarchy + href: core-powershell/ise/the-ise-object-model-hierarchy.md + - name: The ObjectModelRoot Object + href: core-powershell/ise/the-objectmodelroot-object.md + - name: The ISEAddOnToolCollection Object + href: core-powershell/ise/the-iseaddontoolcollection-object.md + - name: The ISEAddOnTool Object + href: core-powershell/ise/the-iseaddontool-object.md + - name: The ISEEditor Object + href: core-powershell/ise/the-iseeditor-object.md + - name: The ISEFileCollection Object + href: core-powershell/ise/the-isefilecollection-object.md + - name: The ISEFile Object + href: core-powershell/ise/the-isefile-object.md + - name: The ISEMenuItemCollection Object + href: core-powershell/ise/the-isemenuitemcollection-object.md + - name: The ISEMenuItem Object + href: core-powershell/ise/the-isemenuitem-object.md + - name: The ISEOptions Object + href: core-powershell/ise/the-iseoptions-object.md + - name: The ISESnippetCollection Object + href: core-powershell/ise/the-isesnippetcollection-object.md + - name: The ISESnippetObject + href: core-powershell/ise/the-isesnippetobject.md + - name: The PowerShellTabCollection Object + href: core-powershell/ise/the-powershelltabcollection-object.md + - name: The PowerShellTab Object + href: core-powershell/ise/the-powershelltab-object.md - name: Visual Studio Code items: - name: Using Visual Studio Code href: core-powershell/vscode/using-vscode.md - - name: Running Remote Commands - href: core-powershell/running-remote-commands.md - items: - - name: PowerShell Remoting Over SSH - href: core-powershell/SSH-Remoting-in-PowerShell-Core.md - - name: WS-Management (WSMan) Remoting in PowerShell Core - href: core-powershell/WSMan-Remoting-in-PowerShell-Core.md - name: Web Access - href: core-powershell/web-access.md + href: '' items: - name: Authorization rules and security features of Windows PowerShell web access href: core-powershell/web-access/authorization-rules-and-security-features-of-windows-powershell-web-access.md @@ -94,150 +147,6 @@ href: core-powershell/web-access/use-the-web-based-windows-powershell-console.md - name: Workflows Guide href: core-powershell/workflows-guide.md - - name: Getting Started - href: '' - items: - - name: Basic cookbooks - href: getting-started/basic-cookbooks.md - items: - - name: Appendix 1 Compatibility Aliases - href: getting-started/cookbooks/appendix-1---compatibility-aliases.md - - name: Appendix 2 Creating a Custom PowerShell Shortcut - href: getting-started/cookbooks/appendix-2---creating-a-custom-powershell-shortcut.md - - name: Basic cookbooks reference - href: getting-started/cookbooks/basic-cookbooks-reference.md - - name: Changing Computer State - href: getting-started/cookbooks/changing-computer-state.md - - name: Collecting Information About Computers - href: getting-started/cookbooks/collecting-information-about-computers.md - - name: Creating .NET and COM Objects New Object - href: getting-started/cookbooks/creating-.net-and-com-objects--new-object-.md - - name: Creating a Custom Input Box - href: getting-started/cookbooks/creating-a-custom-input-box.md - - name: Creating a Graphical Date Picker - href: getting-started/cookbooks/creating-a-graphical-date-picker.md - - name: Getting WMI Objects Get WmiObject - href: getting-started/cookbooks/getting-wmi-objects--get-wmiobject-.md - - name: Managing Current Location - href: getting-started/cookbooks/managing-current-location.md - - name: Managing Processes with Process Cmdlets - href: getting-started/cookbooks/managing-processes-with-process-cmdlets.md - - name: Managing Services - href: getting-started/cookbooks/managing-services.md - - name: Managing Windows PowerShell Drives - href: getting-started/cookbooks/managing-windows-powershell-drives.md - - name: Manipulating Items Directly - href: getting-started/cookbooks/manipulating-items-directly.md - - name: Multiple selection List Boxes - href: getting-started/cookbooks/multiple-selection-list-boxes.md - - name: Other Useful Scripting Objects - href: getting-started/cookbooks/other-useful-scripting-objects.md - - name: Performing Networking Tasks - href: getting-started/cookbooks/performing-networking-tasks.md - - name: Redirecting Data with Out Cmdlets - href: getting-started/cookbooks/redirecting-data-with-out---cmdlets.md - - name: Removing Objects from the Pipeline Where Object - href: getting-started/cookbooks/removing-objects-from-the-pipeline--where-object-.md - - name: Repeating a Task for Multiple Objects ForEach Object - href: getting-started/cookbooks/repeating-a-task-for-multiple-objects--foreach-object-.md - - name: Selecting Items from a List Box - href: getting-started/cookbooks/selecting-items-from-a-list-box.md - - name: Selecting Parts of Objects Select Object - href: getting-started/cookbooks/selecting-parts-of-objects--select-object-.md - - name: Sorting Objects - href: getting-started/cookbooks/sorting-objects.md - - name: Using Format Commands to Change Output View - href: getting-started/cookbooks/using-format-commands-to-change-output-view.md - - name: Using Static Classes and Methods - href: getting-started/cookbooks/using-static-classes-and-methods.md - - name: Viewing Object Structure Get Member - href: getting-started/cookbooks/viewing-object-structure--get-member-.md - - name: Working with Files and Folders - href: getting-started/cookbooks/working-with-files-and-folders.md - - name: Working With Files Folders and Registry Keys - href: getting-started/cookbooks/working-with-files-folders-and-registry-keys.md - - name: Working with Objects - href: getting-started/cookbooks/working-with-objects.md - - name: Working with Printers - href: getting-started/cookbooks/working-with-printers.md - - name: Working with Registry Entries - href: getting-started/cookbooks/working-with-registry-entries.md - - name: Working with Registry Keys - href: getting-started/cookbooks/working-with-registry-keys.md - - name: Working with Software Installations - href: getting-started/cookbooks/working-with-software-installations.md - - name: Fundamentals - href: '' - items: - - name: About Windows PowerShell - href: getting-started/fundamental/about-windows-powershell.md - - name: Exploring the Windows PowerShell ISE - href: getting-started/fundamental/exploring-the-windows-powershell-ise.md - - name: Getting Detailed Help Information - href: getting-started/fundamental/getting-detailed-help-information.md - - name: Getting Information About Commands - href: getting-started/fundamental/getting-information-about-commands.md - - name: Learning Windows PowerShell Names - href: getting-started/fundamental/learning-windows-powershell-names.md - - name: Object Pipeline - href: getting-started/fundamental/object-pipeline.md - - name: Scripting with Windows PowerShell - href: getting-started/fundamental/scripting-with-windows-powershell.md - - name: Understanding Important Windows PowerShell Concepts - href: getting-started/fundamental/understanding-important-windows-powershell-concepts.md - - name: Understanding the Windows PowerShell Pipeline - href: getting-started/fundamental/understanding-the-windows-powershell-pipeline.md - - name: Using Familiar Command Names - href: getting-started/fundamental/using-familiar-command-names.md - - name: Using Variables to Store Objects - href: getting-started/fundamental/using-variables-to-store-objects.md - - name: Using Windows PowerShell - href: getting-started/fundamental/using-windows-powershell.md - - name: Using Windows PowerShell for Administration - href: getting-started/fundamental/using-windows-powershell-for-administration.md - - name: Windows PowerShell Basics - href: getting-started/fundamental/windows-powershell-basics.md - - name: Windows PowerShell Integrated Scripting Environment ISE - href: getting-started/fundamental/windows-powershell-integrated-scripting-environment--ise-.md - - name: Fundamental Concepts - href: getting-started/fundamental-concepts.md - - name: Getting Ready to Use Windows PowerShell - href: getting-started/getting-ready-to-use-windows-powershell.md - - name: Getting Started with Windows PowerShell - href: getting-started/getting-started-with-windows-powershell.md - - name: More PowerShell learning - href: getting-started/more-powershell-learning.md - - name: Setup - href: '' - items: - - name: Installing PowerShell Core on Windows - href: setup/Installing-PowerShell-Core-on-Windows.md - - name: Installing PowerShell Core on macOS and Linux - href: setup/Installing-PowerShell-Core-on-macOS-and-Linux.md - - name: Accessibility in Windows PowerShell ISE - href: setup/accessibility-in-windows-powershell-ise.md - - name: Installing the Windows PowerShell 2.0 Engine - href: setup/installing-the-windows-powershell-2.0-engine.md - - name: Installing the Windows PowerShell SDK - href: setup/installing-the-windows-powershell-sdk.md - - name: Installing Windows PowerShell - href: setup/installing-windows-powershell.md - - name: PS remoting second hop - href: setup/ps-remoting-second-hop.md - - name: Setup reference - href: setup/setup-reference.md - - name: Starting the 32 Bit Version of Windows PowerShell - href: setup/starting-the-32-bit-version-of-windows-powershell.md - - name: Starting the Windows PowerShell 2.0 Engine - href: setup/starting-the-windows-powershell-2.0-engine.md - - name: Starting Windows PowerShell - href: setup/starting-windows-powershell.md - - name: Starting Windows PowerShell on Earlier Versions of Windows - href: setup/starting-windows-powershell-on-earlier-versions-of-windows.md - - name: Windows PowerShell System Requirements - href: setup/windows-powershell-system-requirements.md - - name: WinRMSecurity - href: setup/winrmsecurity.md - name: What's New href: '' items: @@ -251,5 +160,77 @@ href: whats-new/what-s-new-in-powershell-core-60.md - name: PowerShell Core Support Lifecycle href: PowerShell-Core-Support.md - - name: Glossary - href: windows-powershell-glossary.md + - name: Learn more + href: '' + items: + - name: More PowerShell learning + href: getting-started/more-powershell-learning.md + - name: Glossary + href: windows-powershell-glossary.md +- name: Sample scripts + href: getting-started/fundamental/using-windows-powershell-for-administration.md + items: + - name: Changing Computer State + href: getting-started/cookbooks/changing-computer-state.md + - name: Collecting Information About Computers + href: getting-started/cookbooks/collecting-information-about-computers.md + - name: Creating .NET and COM Objects - New-Object + href: getting-started/cookbooks/creating-.net-and-com-objects--new-object-.md + - name: Creating a Custom Input Box + href: getting-started/cookbooks/creating-a-custom-input-box.md + - name: Creating a Graphical Date Picker + href: getting-started/cookbooks/creating-a-graphical-date-picker.md + - name: Getting WMI Objects - Get-WmiObject + href: getting-started/cookbooks/getting-wmi-objects--get-wmiobject-.md + - name: Managing Current Location + href: getting-started/cookbooks/managing-current-location.md + - name: Managing Processes with Process Cmdlets + href: getting-started/cookbooks/managing-processes-with-process-cmdlets.md + - name: Managing Services + href: getting-started/cookbooks/managing-services.md + - name: Managing Windows PowerShell Drives + href: getting-started/cookbooks/managing-windows-powershell-drives.md + - name: Manipulating Items Directly + href: getting-started/cookbooks/manipulating-items-directly.md + - name: Multiple selection List Boxes + href: getting-started/cookbooks/multiple-selection-list-boxes.md + - name: Other Useful Scripting Objects + href: getting-started/cookbooks/other-useful-scripting-objects.md + - name: Performing Networking Tasks + href: getting-started/cookbooks/performing-networking-tasks.md + - name: Redirecting Data with Out Cmdlets + href: getting-started/cookbooks/redirecting-data-with-out---cmdlets.md + - name: Removing Objects from the Pipeline - Where-Object + href: getting-started/cookbooks/removing-objects-from-the-pipeline--where-object-.md + - name: Repeating a Task for Multiple Objects - ForEach-Object + href: getting-started/cookbooks/repeating-a-task-for-multiple-objects--foreach-object-.md + - name: Selecting Items from a List Box + href: getting-started/cookbooks/selecting-items-from-a-list-box.md + - name: Selecting Parts of Object - Select-Object + href: getting-started/cookbooks/selecting-parts-of-objects--select-object-.md + - name: Sorting Objects + href: getting-started/cookbooks/sorting-objects.md + - name: Using Format Commands to Change Output View + href: getting-started/cookbooks/using-format-commands-to-change-output-view.md + - name: Using Static Classes and Methods + href: getting-started/cookbooks/using-static-classes-and-methods.md + - name: Viewing Object Structure - Get-Member + href: getting-started/cookbooks/viewing-object-structure--get-member-.md + - name: Working with Files and Folders + href: getting-started/cookbooks/working-with-files-and-folders.md + - name: Working With Files Folders and Registry Keys + href: getting-started/cookbooks/working-with-files-folders-and-registry-keys.md + - name: Working with Objects + href: getting-started/cookbooks/working-with-objects.md + - name: Working with Printers + href: getting-started/cookbooks/working-with-printers.md + - name: Working with Registry Entries + href: getting-started/cookbooks/working-with-registry-entries.md + - name: Working with Registry Keys + href: getting-started/cookbooks/working-with-registry-keys.md + - name: Working with Software Installations + href: getting-started/cookbooks/working-with-software-installations.md + - name: Appendix 1 Compatibility Aliases + href: getting-started/cookbooks/appendix-1---compatibility-aliases.md + - name: Appendix 2 Creating a Custom PowerShell Shortcut + href: getting-started/cookbooks/appendix-2---creating-a-custom-powershell-shortcut.md