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)

    141 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…

        15 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 →
        • 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 →
              • Have separate about_Classes and about_DSC_Classes

                The about_Classes help file should not have any DSC class information except for a "See Also" reference to a separate about_DSC_Classes, which will of course have lots of details for DSC.

                This will help combat the perception that PowerShell classes are not "real" classes for serious programmers, and that PowerShell classes were not added just for the sake of supporting DSC.

                The about_Classes file should be further fleshed out so that C#, Java and Python developers will know what to (not) expect when using PowerShell classes.

                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

                  In Queue  ·  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 →
                    • 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…

                      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 →
                        • 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…

                          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 →
                          • 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 →
                                • 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

                                  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

                                    2 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                                  • about_Escape_Characters doesn't mention syntax requirements

                                    Please mention that, when using a backtick as a continuation character, there must be no trailing space (or it escapes the space) and there must be a preceding space or the preceding token must be enclosed.

                                    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 →
                                    • Help for Get-Service shows the Name parameter as accept wildcards = false

                                      The documentation for Get-Help Get-Service -Parameter Name states that the Name parameter accepts wildcards but the value for "Accept wildcard characters?" shows false

                                      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 →
                                      • 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 →
                                          ← Previous 1 3
                                          • Don't see your idea?

                                          Feedback and Knowledge Base