About Help

Choose a topic from the list on the left or search for a specific topic. Choose a topic from the list or search for a specific topic.
Cmdlets  Providers
 

about_Windows_PowerShell_5.0

Windows_Powershell_5.0

 

SHORT DESCRIPTION

    Describes new features that are included in  
    Windows PowerShell 5.0. 
     
 

LONG DESCRIPTION

 
    Windows PowerShell 5.0 includes significant new features that extend its 
    use, improve its usability, and allow you to control and manage Windows-based 
    environments more easily and comprehensively. 
 
    Windows PowerShell 5.0 is backward-compatible. Cmdlets, providers, modules,  
    snap-ins, scripts, functions, and profiles that were designed for Windows 
    PowerShell 4.0, Windows PowerShell 3.0, and Windows PowerShell 2.0 generally 
    work in Windows PowerShell 5.0 without changes. 
 
    Windows PowerShell 5.0 is installed by default on Windows Server Technical 
    Preview and Windows Technical Preview. To install Windows PowerShell 5.0 on 
    Windows Server 2012 R2, Windows 8.1 Enterprise, or Windows 8.1 Pro, download 
    and install Windows Management Framework 5.0 Preview.  
    (http://www.microsoft.com/download/details.aspx?id=44070) 
    Be sure to read the download details, and meet all system requirements, 
    before you install Windows Management Framework 5.0 Preview. 
 
    You can also read about changes to Windows PowerShell 5.0 in the Microsoft 
    TechNet topic, "What's New in Windows PowerShell." 
    (http://go.microsoft.com/fwlink/?LinkID=512808) 
 
 

NEW FEATURES

 
    New features in Windows PowerShell 
 
    -- Starting in Windows PowerShell 5.0, you can develop by using classes, 
       by using formal syntax and semantics that are similar to other object-oriented 
       programming languages. Class, Enum, and other keywords have been added to the 
       Windows PowerShell language to support the new feature. For more information 
       about working with classes, see about_Classes. 
    -- In collaboration with Microsoft Research, a new cmdlet, ConvertFrom-String, 
       has been added. ConvertFrom-String lets you extract and parse structured  
       objects from the content of text strings. For more information, see 
       ConvertFrom-String. 
    -- A new module, Microsoft.PowerShell.Archive, includes cmdlets that let you  
       compress files and folders into archive (also known as ZIP) files, extract 
       files from existing ZIP files, and update ZIP files with newer versions 
       of files compressed within them. 
    -- A new module, OneGet, lets you discover and install software packages on 
       the Internet. The OneGet module is a manager or multiplexer of existing 
       package managers (also called package providers) to unify Windows package 
       management with a single Windows PowerShell interface. 
    -- A new module, PowerShellGet, lets you find, install, publish, and update 
       modules and DSC resources on the PowerShell Resource Gallery, or on an internal 
       module repository that you can set up by running the Register-PSRepository cmdlet. 
    -- New-Item, Remove-Item, and Get-ChildItem have been enhanced to support  
       creating and managing symbolic links. The ItemType parameter for New-Item 
       accepts a new value, SymbolicLink. Now you can create symbolic links in a 
       single line by running the New-Item cmdlet. 
    -- Windows PowerShell transcription has been improved to apply to all hosting 
       applications (such as Windows PowerShell ISE) in addition to the console host 
       (powershell.exe). Transcription options (including enabling a system-wide  
       transcript) can be configured by enabling the Turn on PowerShell Transcription 
       Group Policy setting, found in 
       Administrative Templates/Windows Components/Windows PowerShell. 
    -- A new detailed script tracing feature lets you enable detailed tracking and 
       analysis of Windows PowerShell scripting use on a system. After you enable 
       detailed script tracing, Windows PowerShell logs all script blocks to the 
       Event Tracing for Windows (ETW) event log, Microsoft-Windows-PowerShell/Operational. 
    -- Starting in Windows PowerShell 5.0, new Cryptographic Message Syntax cmdlets 
       support encryption and decryption of content by using the IETF standard format 
       for cryptographically protecting messages as documented by RFC5652 
       (http://tools.ietf.org/html/rfc5652). The Get-CmsMessage, Protect-CmsMessage, 
       and Unprotect-CmsMessage cmdlets have been added to the  
       Microsoft.PowerShell.Security module. 
    -- New cmdlets in the Microsoft.PowerShell.Utility module, Get-Runspace, 
       Debug-Runspace, Get-RunspaceDebug, Enable-RunspaceDebug, and  
       Disable-RunspaceDebug, let you set debug options on a runspace, and start 
       and stop debugging on a runspace. For debugging arbitrary runspaces—that is, 
       runspaces that are not the default runspace for a Windows PowerShell console 
       or Windows PowerShell ISE session—Windows PowerShell lets you set breakpoints 
       in a script, and have added breakpoints stop the script from running until 
       you can attach a debugger to debug the runspace script. Nested debugging 
       support for arbitrary runspaces has been added to the Windows PowerShell 
       script debugger for runspaces. 
    -- New cmdlets Enter-PSHostProcess and Exit-PSHostProcess let you debug  
       Windows PowerShell scripts in processes separate from the current process 
       that is running in the Windows PowerShell console. Run Enter-PSHostProcess 
       to enter, or attach to, a specific process ID, and then run Get-Runspace to 
       return the active runspaces within the process. Run Exit-PSHostProcess to 
       detach from the process when you are finished debugging the script within  
       the process. 
    -- A new Wait-Debugger cmdlet has been added to the Microsoft.PowerShell.Utility 
       module. You can run Wait-Debugger to stop a script in the debugger before  
       running the next statement in the script. 
    -- The Windows PowerShell Workflow debugger now supports command or tab completion, 
       and you can debug nested workflow functions. You can now press Ctrl+Break to 
       enter the debugger in a running script, in both local and remote sessions, and 
       in a workflow script. 
    -- A Debug-Job cmdlet has been added to the Microsoft.PowerShell.Core module to 
       debug running job scripts for Windows PowerShell Workflow, background, and  
       jobs running in remote sessions. 
    -- A new state, AtBreakpoint, has been added for Windows PowerShell jobs. The 
       AtBreakpoint state applies when a job is running a script that includes set 
       breakpoints, and the script has hit a breakpoint. When a job is stopped at a 
       debug breakpoint, you must debug the job by running the Debug-Job cmdlet. 
    -- Windows PowerShell 5.0 implements support for multiple versions of a single 
       Windows PowerShell module in the same folder in $PSModulePath. A  
       RequiredVersion property has been added to the ModuleSpecification class to 
       help you get the desired version of a module; this property is  
       mutually-exclusive with the ModuleVersion property. RequiredVersion is now 
       supported as part of the value of the FullyQualifiedName parameter of the 
       Get-Module, Import-Module, and Remove-Module cmdlets. 
    -- You can now perform module version validation by running the  
       Test-ModuleManifest cmdlet. 
    -- Results of the Get-Command cmdlet now display a Version column; a new Version 
       property has been added to the CommandInfo class. Get-Command shows commands 
       from multiple versions of the same module. The Version property is also part 
       of derived classes of CmdletInfo: CmdletInfo and ApplicationInfo. 
    -- A new Get-ItemPropertyValue cmdlet lets you get the value of a property without 
       using dot notation. For example, in older releases of Windows PowerShell, you 
       can run the following command to get the value of the Application Base property 
       of the PowerShellEngine registry key: (Get-ItemProperty -Path HKLM:\SOFTWARE\ 
       Microsoft\PowerShell\3\PowerShellEngine -Name ApplicationBase).ApplicationBase. 
       Starting in Windows PowerShell 5.0, you can run Get-ItemPropertyValue -Path HKLM: 
       \SOFTWARE\Microsoft\PowerShell\3\PowerShellEngine -Name ApplicationBase. 
    -- A new NetworkSwitch module contains cmdlets that enable you to apply switch, 
       virtual LAN (VLAN), and basic Layer 2 network switch port configuration to 
       Windows Server 2012 R2 (and later releases) logo-certified network switches. 
    -- The FullyQualifiedName parameter has been added to Import-Module and 
       Remove-Module cmdlets, to support storing multiple versions of a single module. 
    -- Save-Help, Update-Help, Import-PSSession, Export-PSSession, and Get-Command 
       have a new parameter, FullyQualifiedModule, of type ModuleSpecification. Add 
       this parameter to specify a module by its fully qualified name. 
    -- The value of $PSVersionTable.PSVersion has been updated to 5.0. 
 
 
    New features in Windows PowerShell Desired State Configuration 
 
    -- Windows PowerShell language enhancements let you define Windows PowerShell 
       Desired State Configuration (DSC) resources by using classes. 
       Import-DscResource is now a true dynamic keyword; Windows PowerShell parses 
       the specified module’s root module, searching for classes that contain the 
       DscResource attribute. You can now use classes to define DSC resources, 
       in which neither a MOF file nor a DSCResource subfolder in the module 
       folder is required. A Windows PowerShell module file can contain multiple 
       DSC resource classes. 
    -- A new parameter, ThrottleLimit, has been added to the following cmdlets in 
       the PSDesiredStateConfiguration module. Add the ThrottleLimit parameter  
       to specify the number of target computers or devices on which you want the 
       command to work at the same time. 
         -- Get-DscConfiguration 
         -- Get-DscConfigurationStatus 
         -- Get-DscLocalConfigurationManager 
         -- Restore-DscConfiguration 
         -- Test-DscConfiguration 
         -- Compare-DscConfiguration 
         -- Publish-DscConfiguration 
         -- Set-DscLocalConfigurationManager 
         -- Start-DscConfiguration 
         -- Update-DscConfiguration 
    -- With centralized DSC error reporting, rich error information is not only 
       logged in the event log, but it can be sent to a central location for later 
       analysis. You can use this central location to store DSC configuration errors 
       that have occurred for any server in their environment. After the report 
       server is defined in the meta-configuration, all errors are sent to the 
       report server, and then stored in a database. You can set up this functionality 
       regardless of whether or not a target node is configured to pull configurations 
       from a pull server. 
    -- Improvements to Windows PowerShell ISE ease DSC resource authoring. You can 
       now do the following. 
         -- List all DSC resources within a configuration or node block by entering 
            Ctrl+Space on a blank line within the block. 
         -- Automatic completion on resource properties of the enumeration type. 
         -- Automatic completion on the DependsOn property of DSC resources, based 
            on other resource instances in the configuration. 
         -- Improved tab completion of resource property values. 
    -- A new DscLocalConfigurationManager attribute designates a configuration block 
       as a meta-configuration, which is used to configure the DSC Local Configuration 
       Manager. This attribute restricts a configuration to containing only items 
       which configure the DSC Local Configuration Manager. During processing,  
       this configuration generates a *.meta.mof file that is then sent to the 
       appropriate target nodes by running the Set-DscLocalConfigurationManager cmdlet. 
    -- Partial configurations are now allowed in Windows PowerShell 5.0. You can 
       deliver configuration documents to a node in fragments. For a node to receive 
       multiple fragments of a configuration document, the node’s Local Configuration 
       Manager must be first set to specify the expected fragments. 
    -- Cross-computer synchronization is new in DSC in Windows PowerShell 5.0. By 
       using the built-in WaitFor* resources (WaitForAll, WaitForAny, and 
       WaitForSome), you can now specify dependencies across computers during 
       configuration runs, without external orchestrations. These resources provide 
       node-to-node synchronization by using CIM connections over the WS-Man protocol. 
       A configuration can wait for another computer’s specific resource state to change. 
    -- Just Enough Administration (JEA), a new delegation security feature, leverages 
       DSC and Windows PowerShell constrained runspaces to help secure enterprises 
       from data loss or compromise by employees, whether intentional or unintentional. 
       For more information about JEA, including where you can download the xJEA DSC 
       resource, see Just Enough Administration, Step by Step. 
       (http://ppe.blogs.technet.com/b/privatecloud/archive/2014/05/14/just-enough-administration-step-by-step.aspx) 
    -- The following new cmdlets have been added to the PSDesiredStateConfiguration 
       module. 
         -- A new Get-DscConfigurationStatus cmdlet gets high-level information about 
            configuration status from a target node. You can obtain the status of the 
            last, or of all configurations. 
         -- A new Compare-DscConfiguration cmdlet compares a specified configuration 
            with the actual state of one or more target nodes. 
         -- A new Publish-DscConfiguration cmdlet copies a configuration MOF file to  
            a target node, but does not apply the configuration. The configuration is 
            applied during the next consistency pass, or when you run the 
            Update-DscConfiguration cmdlet. 
         -- A new Test-DscConfiguration cmdlet lets you verify that a resulting 
            configuration matches the desired configuration, returning either True if 
            the configuration matches the desired configuration, or False if the actual 
            configuration does not match the desired configuration. 
         -- A new Update-DscConfiguration cmdlet forces a configuration to be processed. 
            If the Local Configuration Manager is in pull mode, the cmdlet gets the  
            configuration from the pull server before applying it. 
 
 
    New features in Windows PowerShell ISE 
    -- You can now edit remote Windows PowerShell scripts and files in a local copy of 
       Windows PowerShell ISE, by running Enter-PSSession to start a remote session on  
       the computer that’s storing the files you want to edit, and then running PSEdit 
       <path and file name on the remote computer>. This feature eases editing Windows 
       PowerShell files that are stored on the Server Core installation option of 
       Windows Server, where Windows PowerShell ISE cannot run. 
    -- The Start-Transcript cmdlet is now supported in Windows PowerShell ISE. 
    -- You can now debug remote scripts in Windows PowerShell ISE. 
    -- A new menu command, Break All (Ctrl+B), breaks into the debugger for both 
       local and remotely-running scripts. 
 
 
    New features in Windows PowerShell Web Services (Management OData IIS Extension) 
    -- Starting in Windows PowerShell 5.0, you can generate a set of Windows PowerShell 
       cmdlets based on the functionality exposed by a given OData endpoint, by 
       running the Export-ODataEndpointProxy cmdlet. 
 
 
    Notable bug fixes in Windows PowerShell 5.0 
    -- Windows PowerShell 5.0 includes a new COM implementation, which offers 
       significant performance improvements when you are working with COM objects. 
       For a video demonstration of the effect, see Com_Perf_Improvements. 
       (http://1drv.ms/1qu3UPZ) 
 
    For more information about Windows PowerShell 5.0, visit the following web 
    sites: 
 
    -- Windows PowerShell Scripting website 
       http://go.microsoft.com/fwlink/?LinkID=106031 
 
    -- Windows PowerShell Team Blog: 
       http://go.microsoft.com/fwlink/?LinkId=143696 
 
    -- Windows PowerShell Web Access 
       http://technet.microsoft.com/library/hh831611.aspx 
 

SEE ALSO

about_Classes
about_Debuggers
about_Desired_State_Configuration
about_Scheduled_Jobs
about_Updatable_Help
Add-Computer
ConvertFrom-String
Debug-Job
Disable-JobTrigger
Enable-JobTrigger
Get-Module
Get-Process
Invoke-RestMethod
New-JobTrigger
Register-ScheduledJob
Remove-Computer
Save-Help
Set-ExecutionPolicy
Set-JobTrigger
Set-ScheduledJob
Update-Help
 
 

KEYWORDS

    What's New in Windows PowerShell 5.0