PowerShell

The PowerShell forum accepts bug reports as well as feedback and suggestions. For more information, check out the PowerShell Homepage

The following is a list of the states we use to track items.

status meaning
survey We saw this and we are considering it. Please upvote if it’s important to you.
needs more information We don’t understand the issue and need additional details.
investigating We are looking at this internally to understand things like: scenario, reproduction of issue, costing, or other technical details.
in queue The issue is understood and in our unprioritized backlog. Your votes will be used to drive prioritization of this work.

Please feel free to provide feedback or file bugs here.

(thinking…)

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can support and comment on it.

If it doesn't exist, you can post your idea so others can support it.

Enter your idea and we'll search to see if someone has already suggested it.

  • Hot ideas
  • Top ideas
  • New ideas
  • My feedback
  1. Add PowerShell tab and examples to .NET reference pages in MSDN

    Votes from Connect: 391

    Original Date Submitted: 5/21/2015 12:20:32 AM

    Description:
    ********Contact Information********
    Handle: June Blender
    Site Name: PowerShell
    Feedback ID: 1351032
    ***************************************

    Problem Description:
    PowerShell users often read .NET reference pages in MSDN. It's all but required, because Get-Help doesn't describe object members. However, in the Examples section of .NET reference pages, there are no PowerShell examples; not even a PowerShell tab.

    MSDN says they cannot demonstrate a demand for PowerShell examples. I'd like to use this feature request to demonstrate the demand.

    Product Studio item created by Connect Synchronizer due to creation of feedback ID 1351032 (http://connect.microsoft.com/PowerShell/feedback/ViewFeedback.aspx?FeedbackID=1351032)

    148 votes
    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)

      We’ll send you updates on this idea

      21 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
    • about_Language_Keywords is missing 4.0-5.0 keywords

      about_Language_Keywords for PowerShell 5.0 (https://technet.microsoft.com/library/hh847744.aspx) is missing all of the new keywords for PowerShell 4.0 and 5.0, including critical keywords, such as Configuration, Class, and Enum.

      18 votes
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        Password icon
        I agree to the terms of service
        Signed in as (Sign out)

        We’ll send you updates on this idea

        survey  ·  1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
      • Comment-Based Help: Allow multi-line examples

        Votes from Connect: 8

        Original Date Submitted: 8/22/2014 11:58:54 PM

        Description:
        ********Contact Information********
        Handle: Aaron Jensen
        Site Name: PowerShell
        Feedback ID: 952833
        ***************************************

        Frequency: Always Happens
        Regression: Yes, this happens in all previous versions

        Problem Description:
        Currently, when using comment-based help, you're limited to one line of code for an example. This is extremely limiting, especially when trying to document DSC resources, since they span multiple lines by default. Also, some examples would be more useful with some extra lines. The current alternative is to use XML-based help, but the MAML schema is extremely verbose and complicated.

        What I'd like…

        16 votes
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          I agree to the terms of service
          Signed in as (Sign out)

          We’ll send you updates on this idea

          0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
        • Duplicate help files in PSWorkflow module break Get-Help

          At some point in the 5.0 time period, Update-Help installed About topic files in the en-US directory for the PSWorkflow module with .txt (not .help.txt) file name extensions.

          e.g. about_Foreach-Parallel.txt

          Later, this was fixed and Update-Help installed the same help files in the same directory with the (correct) ".help.txt" file name extension.

          e.g. about_Foreach-Parallel.help.txt

          Now, the PSWorkflow\en-US directory has 9 pairs of files that are identical except for the file name extension.

          about_ActivityCommonParameters.help.txt
          about_ActivityCommonParameters.txt
          about_Checkpoint-Workflow.help.txt
          about_Checkpoint-Workflow.txt
          about_Foreach-Parallel.help.txt
          about_Foreach-Parallel.txt
          about_InlineScript.help.txt
          about_InlineScript.txt
          about_Parallel.help.txt
          about_Parallel.txt
          about_Sequence.help.txt
          about_Sequence.txt
          about_Suspend-Workflow.help.txt
          about_Suspend-Workflow.txt
          about_WorkflowCommonParameters.help.txt
          about_WorkflowCommonParameters.txt
          about_Workflows.help.txt
          about_Workflows.txt

          Get-Help should ignore the .txt files (must have changed in…

          6 votes
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            I agree to the terms of service
            Signed in as (Sign out)

            We’ll send you updates on this idea

            survey  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
          • Syntax changes when using help like .Synopsis

            When I add a help section to my script, the Get-Help cmdlet displays a different syntax. Here is a MWE:

            #Require -Version 4.0
            function global:Test-Syntax {
            <#
            .Synopsis
            Cmdlet tests ValidateSet
            #>
            [CmdletBinding()]
            # parameter check
            param (
            [ValidateSet("one", "two", "three")]
            [string]$testparam
            )
            Write-Verbose "`$testparam: $testparam"
            }

            Get-Help Test-Syntax shows the following in syntax section:

            SYNTAX
            Test-Syntax [[-testparam] <String>] [<CommonParameters>]

            After I remove .Synopsis or the whole help section, I receive the following from Get-Help:

            SYNTAX
            Test-Syntax [[-testparam] <string> {one | two | three}] [<CommonParameters>]

            I would like to have the second one, because a user directly get the information…

            6 votes
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              Password icon
              I agree to the terms of service
              Signed in as (Sign out)

              We’ll send you updates on this idea

              1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
            • Get-Help cmdlet should skip error and continue updating help doc.

              I know that there are many cmdlets help documentation not completed yet. But, it's a pain when trying to use the "Update-help" cmdlet and see it error-out due to an unfinished module help.

              I think it should be a good idea to display the error and continue (or try) update the rest of our installed module(s).

              In my case, I'm getting an error update the help on the new SQLServer module. But this is now completing the update for the rest of my existing module.

              If this update is done alphabetically then the update is stopping at the SQLServer module…

              6 votes
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                Password icon
                I agree to the terms of service
                Signed in as (Sign out)

                We’ll send you updates on this idea

                survey  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
              • Help for dynamic parameters of Add-Content is broken

                Dynamic parameters of a cmdlet that are added by a provider are documented in the <providerHelp>\<cmdletHelpPaths> element of the help XML file.

                The FileSystem provider adds the following parameters to Add-Content:

                PS C:\> (Get-Command Add-Content).ParameterSets.Parameters | Where IsDynamic | foreach Name | Sort -Unique
                Encoding
                NoNewline
                Stream

                However, the Encoding and Stream parameters are documented in the primary help file, Microsoft.PowerShell.Commands.Management.dll-help.xml, so they appear in Get-Help even in provider drives where the parameter is not valid.

                PS Function:\> (Get-Help Add-Content -Path function:).Parameters.Parameter | where Name -notin $common | foreach Name | Sort -Unique
                Credential
                Encoding # <----
                Exclude
                Filter
                Force …

                6 votes
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  Password icon
                  I agree to the terms of service
                  Signed in as (Sign out)

                  We’ll send you updates on this idea

                  investigating  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                • Better documentation on writing Providers in .NET

                  Votes from Connect: 4

                  Original Date Submitted: 5/9/2015 3:36:45 AM

                  Description:
                  ********Contact Information********
                  Handle: TofuBug
                  Site Name: PowerShell
                  Feedback ID: 1315394
                  ***************************************

                  Problem Description:
                  It would be a VERY nice thing to see an expanded set of documentation and examples related to writing PowerShell providers that go beyond the simple examples currently related to access databases.

                  A webcast or training video would be awesome! Especially to go over things like

                  -How to determine what type of provider would best suit my specific need with actual examples showing those reasons)
                  -What are some things I can do to "think" about things…

                  6 votes
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    Password icon
                    I agree to the terms of service
                    Signed in as (Sign out)

                    We’ll send you updates on this idea

                    0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                  • Get-Help Certificate -ShowWindow

                    Pretty sure this is a bug. When I run

                    Get-Help Certificate -ShowWindow

                    The window outputs:

                    @{CmdletHelpPaths=@{CmdletHelpPath=@{command=System.Management.Automation.PSObject[]; id=Certificate}}; DetailedDescription=System.Management.Automation.PSObject[]; Notes=; Capabilities=System.Management.Automation.PSObject[]; Drives=System.Management.Automation.PSObject[]; Synopsis=Provides access to X.509 certificate stores and certificates in Windows PowerShell.; DynamicParameters=@{DynamicParameter=System.Management.Automation.PSObject[]}; RelatedLinks=@{navigationLink=System.Management.Automation.PSObject[]}; Filters=System.Management.Automation.PSObject[]; Tasks=@{Task=System.Management.Automation.PSObject[]}; Name=Certificate; Category=Provider; Component=; Role=; Functionality=}

                    I'm not a programmer (yet!) but I think this shouldn't be happening.

                    6 votes
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      Password icon
                      I agree to the terms of service
                      Signed in as (Sign out)

                      We’ll send you updates on this idea

                      0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                    • Correction: about_requires

                      In the about_requires documentation, when using a hashtable to provide a required module version or GUID, it's not clear that the values in the hash table need to be quoted. The example in the documentation is:

                      #Requires -Modules PSWorkflow, @{ModuleName="PSScheduledJob";ModuleVersion=1.0.0.0}

                      and should be

                      #Requires -Modules PSWorkflow, @{ModuleName="PSScheduledJob";ModuleVersion="1.0.0.0"}

                      5 votes
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        Password icon
                        I agree to the terms of service
                        Signed in as (Sign out)

                        We’ll send you updates on this idea

                        0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                      • Help for DocumentEncryptionCert dynamic parameter is missing

                        There is no help content for the Document EncryptionCert dynamic parameter of Get-ChildItem.

                        Because this dynamic parameter is added by the Certificate provider, it should be documented in the <providerHelp>\<cmdletHelpPaths> section of Microsoft.PowerShell.Security.dll-help.xml.

                        5 votes
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          Password icon
                          I agree to the terms of service
                          Signed in as (Sign out)

                          We’ll send you updates on this idea

                          investigating  ·  1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                        • Documentation on Remoting Session Configuration is missing for PS5.0

                          Help is missing on new options for WinRM remoting in PS 5.0

                          [ADMIN]: PS > get-help New-PSSessionConfigurationFile -Parameter TranscriptDirectory
                          get-help : No parameter matches criteria TranscriptDirectory.
                          At line:1 char:1
                          + get-help New-PSSessionConfigurationFile -Parameter TranscriptDirector ...
                          + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                          + CategoryInfo : InvalidArgument: (System.Manageme...CommandHelpInfo:ProviderCommandHelpInfo) [Get-Help],
                          PSArgumentException
                          + FullyQualifiedErrorId : NoParmsFound,Microsoft.PowerShell.Commands.GetHelpCommand

                          [ADMIN]: PS > New-PSSessionConfigurationFile -TranscriptDirectory

                          5 votes
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            Password icon
                            I agree to the terms of service
                            Signed in as (Sign out)

                            We’ll send you updates on this idea

                            2 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                          • Register-ArgumentCompleter is not documented

                            The cmdlet Register-ArgumentCompleter is not documented.

                            4 votes
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              Password icon
                              I agree to the terms of service
                              Signed in as (Sign out)

                              We’ll send you updates on this idea

                              survey  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                            • Remove-EventLog help appears nonsensical

                              Someone on powershell team ought to have a look at this: https://technet.microsoft.com/en-us/library/hh849786(v=wps.640).aspx

                              The syntax section 'source' parameterset doesn't show usage of the source param.

                              The documentation text under "-InformationAction<System.Management.Automation.ActionPreference]>" and "-InformationVariable<System.String]>" are identical, and appear irrelevant to this command.

                              (Also, for the love of god, can we have a bigger text entry box here?)

                              4 votes
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                Password icon
                                I agree to the terms of service
                                Signed in as (Sign out)

                                We’ll send you updates on this idea

                                0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                              • Help for FileSystem dynamic parameters of Get-ChildItem are broken

                                The FileSystem provider adds the following dynamic parameters to Get-ChildItem:

                                PS C:\> (Get-Command Get-ChildItem).ParameterSets.Parameters | where IsDynamic | foreach Name | Sort -Unique
                                Attributes
                                Directory
                                File
                                Hidden
                                ReadOnly
                                System
                                But, these are all failing in Get-Help in the file system drives.

                                PS C:\> $dynam | foreach { if (!(Get-Help Get-ChildItem -Parameter $_ -ErrorAction SilentlyContinue)) { $_ } }
                                Attributes
                                Directory
                                File
                                Hidden
                                ReadOnly
                                System

                                Unlike the related bugs I've filed, I can't find the error in the help file. These parameters are (correctly) not documented in the cmdlet help, and they are correctly documented in the provider help.

                                PS C:\>…

                                4 votes
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  Password icon
                                  I agree to the terms of service
                                  Signed in as (Sign out)

                                  We’ll send you updates on this idea

                                  investigating  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                                • I wish the output properties of each cmdlet when used with System Center Virtual Machine Manager are somewhere documented.

                                  I wish the output properties of each powershell cmdlet when used with System Center Virtual Machine Manager are somewhere documented.

                                  3 votes
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    Password icon
                                    I agree to the terms of service
                                    Signed in as (Sign out)

                                    We’ll send you updates on this idea

                                    1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                                  • Bug Get-Help Get-Help -Full

                                    Votes from Connect: 1

                                    Original Date Submitted: 8/19/2015 6:21:37 PM

                                    Description:
                                    ********Contact Information********
                                    Handle: H_Ski
                                    Site Name: PowerShell
                                    Feedback ID: 1686799
                                    ***************************************

                                    Frequency: Documentation
                                    Regression:

                                    Problem Description:
                                    PSv4 and PSv5 with updated help (2015-august-19):

                                    .Input says: You can not pipe objects to Get-Help
                                    BUT
                                    Get-Help Get-Help -parameter name says: Accept pipeline input? true (ByPropertyName)

                                    In v5 if you do get-help get-help -full help for gcm and get-item also shows up.

                                    Product Studio item created by Connect Synchronizer due to creation of feedback ID 1686799 (http://connect.microsoft.com/PowerShell/feedback/ViewFeedback.aspx?FeedbackID=1686799).

                                    Repro Steps:
                                    Expected Results:

                                    Internal BugId: 15748

                                    3 votes
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      Password icon
                                      I agree to the terms of service
                                      Signed in as (Sign out)

                                      We’ll send you updates on this idea

                                      0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                                    • Break works outside of loops/switch

                                      Votes from Connect: 6

                                      Original Date Submitted: 5/11/2015 6:44:53 AM

                                      Description:
                                      ********Contact Information********
                                      Handle: June Blender
                                      Site Name: PowerShell
                                      Feedback ID: 1321210
                                      ***************************************

                                      Frequency: Documentation
                                      Regression: 1. # In a script:

                                      Break
                                      Get-Process

                                      2. Run the script. It breaks before Get-Process

                                      3. Read about_Break:
                                      "Describes a statement you can use to immediately exit Foreach, For, While, Do, or Switch statements."

                                      Problem Description:
                                      About_Break says that Break works only in loops/switch. But, Break works in scripts, too. If you place Break in script scope, it ends the script.

                                      For example: "Describes a statement you can use to immediately exit Foreach, For,…

                                      3 votes
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        Password icon
                                        I agree to the terms of service
                                        Signed in as (Sign out)

                                        We’ll send you updates on this idea

                                        1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                                      • Add ONLINEVERSION keyword and FWLINK URL to About topics

                                        Votes from Connect: 13

                                        Original Date Submitted: 12/13/2014 3:52:04 AM

                                        Description:
                                        ********Contact Information********
                                        Handle: June Blender
                                        Site Name: PowerShell
                                        Feedback ID: 1053380
                                        ***************************************

                                        Frequency: Sometimes Happens
                                        Regression: Yes, this happens in all previous versions

                                        Problem Description:
                                        There's no OnlineVersion property of About topics, because they're text, but you can add an all-caps ONLINEVERSION keyword to the text with the forward-link URL of the online version of the help topic. Providing the forward-link URL to the public allows us to link reliably to the online help topic in blog/forum posts.

                                        e.g.
                                        KEYWORDS
                                        about_Common_Parameters

                                        ONLINEVERSION: http://go.microsoft.com/fwlink/?LinkID=113309

                                        SEE ALSO
                                        about_Preference_Variables
                                        Write-Debug

                                        To find…

                                        3 votes
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          Password icon
                                          I agree to the terms of service
                                          Signed in as (Sign out)

                                          We’ll send you updates on this idea

                                          0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                                        • Update-Help : Failed to update Help for the module(s) 'ConfigCI' with UI culture(s) {en-US}

                                          Votes from Connect: 3

                                          Original Date Submitted: 11/26/2015 2:36:27 AM

                                          Description:
                                          ********Contact Information********
                                          Handle: Firgeis
                                          Site Name: PowerShell
                                          Feedback ID: 2057856
                                          ***************************************

                                          Frequency: Always Happens
                                          Regression: I do not know if this issue existed previously

                                          Problem Description:

                                          PS C:\Users\Administrator> Update-Help
                                          Update-Help : Failed to update Help for the module(s) 'ConfigCI' with UI culture(s) {en-US} : The
                                          HelpInfoUri key in the module manifest must resolve to a container or root URL on a website where
                                          stored. The HelpInfoUri 'https://technet.microsoft.com/library/cc732148.aspx'; does not resolve to
                                          At line:1 char:1
                                          + Update-Help
                                          + ~~~~~~~~~~~
                                          + CategoryInfo : InvalidOperation: (:) [Update-Help], Exception
                                          + FullyQualifiedErrorId…

                                          3 votes
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            Password icon
                                            I agree to the terms of service
                                            Signed in as (Sign out)

                                            We’ll send you updates on this idea

                                            0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                                          ← Previous 1 3
                                          • Don't see your idea?

                                          Feedback and Knowledge Base