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. Fix get-help for format-volume

    under example 2 it says the following

    This example performs a full format of the D volume using the FAT32 file system.
    with the example code:
    PS C:\> Format-Volume -DriveLetter C -FileSystem FAT32 -FullFormat –Force
    The example code formats the c drive but the explaination say it will format the d drive could you please make it consistent.

    1 vote
    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 →
    • Dynamic Parameters and Positional parameters do not work as expected

      Problem description and example: https://stackoverflow.com/questions/45021674/how-do-you-specify-both-static-and-dynamic-positional-parameters-in-powershell

      1) It is not clear that the position attribute is relative to other parameters of the same type, and that static parameters always come before dynamic parameters.
      2) If you run get-help (full) on the function described in the link it will show the literal position assignment, not their position as PowerShell expects them (i.e. the static parameter is listed as position 3, when it is actually position 0)
      3) Tabbing through the options list (using ISE or PowerShell) behaves according to the literal position assignment, not their position as PowerShell expects them (i.e. if…

      2 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 →
      • Error in topic about_Pipelines under INVESTIGATING PIPELINE ERRORS

        The example command given under "INVESTIGATING PIPELINE ERRORS" in the about_Pipelines help topic is incorrrect. the example situation is moving a registry entry from one key to another, in the example it's trying to move the entry "product" from the hklm:\software\mycompany\design registry key to the hklm:\software\mycompany\sales key. The second ("fixed") command at the end:

        get-item -path hklm:\software\mycompany\design |
        move-itemproperty -dest hklm:\software\mycompany\design -name product

        should be:

        get-item -path hklm:\software\mycompany\design |
        move-itemproperty -dest hklm:\software\mycompany\sales -name product

        I also think the source and destination seem switched or misplaced throughout that section of the topic, unrelated to the example error given for the purpose…

        1 vote
        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 →
        • Why can't Acrobat save these PowerShell articles?

          I've tried several ways to capture the PowerShell documentation into a single PDF file which I find much more convenient instead of clicking around a Microsoft site. Acrobat just locks up. I've never seen it behave this way before.

          It places PowerShell out of reach for those of us trying to learn new tools.

          Please try it yourself. Acrobat XI Pro.
          - Use the browser plugin "create PDF from webpage"
          - Or start with Acrobat "create PDF"
          - Or Browser / Save as html complete

          Print to PDF is inadequate because webpage links are missing and on the PowerShell pages,…

          1 vote
          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 →
          • WMF 5.1 - Update misleading prerequisite information for Win7 SP1

            WMF 5.1 requires .NET Framework 4.5.2 should indicate :
            WMF 5.1 requires .NET Framework 4.5.2 or later

            1 vote
            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 →
            • New Verb: Demo

              Demo (verb), 'demonstrate the capabilities of (software or equipment).' Another verb to flag that the function/cmdlet is not for production but will demonstrate a key knowledge item, technique, or concept. Where the suggestion for the verb Proto has to do with the (rapid) development path, this would fill a need in training or maintaining on-going knowledge of the language. It's a great suggestion, please up-vote!

              1 vote
              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 →
              • Cmdlet version compatibility

                We need to define with wich version of Powershel and which operating system cmdlets are compatible.

                Could we have this compatibility matrix for each cmdlet in the documentation and also in the help section of each cmdlet?

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

                  11 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 →
                  • Powershell help in 2012r2 Virtual machine (Evaluation copy) won't update

                    Powershell commands: get-help get-vm, update-help will not work in Hyper-V.

                    1 vote
                    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 does not update BitsTransfer

                      Update-Help seems to be unable to update help files for BitsTransfer module. It returns the following error:

                      Update-Help : Failed to update Help for the module(s) 'BitsTransfer' with UI culture(s) {en-US} : The value of the
                      HelpInfoUri key in the module manifest must resolve to a container or root URL on a website where the help files are
                      stored. The HelpInfoUri 'https://technet.microsoft.com/en-us/library/dd819413.aspx'; does not resolve to a container.
                      At line:1 char:1
                      + Update-Help
                      + ~~~~~~~~~~~
                      + CategoryInfo : InvalidOperation: (:) [Update-Help], Exception
                      + FullyQualifiedErrorId : InvalidHelpInfoUri,Microsoft.PowerShell.Commands.UpdateHelpCommand

                      2 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 →
                      • The description attached to the parameters -Delimiter -Encoding -Raw -Stream -Wait (This parameter is not supported by any providers that ar

                        This comment pertains to the help entry for Get-Content (https://msdn.microsoft.com/en-us/powershell/reference/5.0/microsoft.powershell.management/get-content) I Tried to enter the feedback into the actual page but my browser reloaded the page and lost the floating feedback link. Perhaps it was already submitted.

                        The description attached to the parameters
                        -Delimiter
                        -Encoding
                        -Raw
                        -Stream
                        -Wait
                        (This parameter is not supported by any providers that are installed with Windows Powershell.)
                        is both incorrect and useless.

                        It is incorrect because the parameters are supported by the FileSystem provider (at least).

                        It is useless because it gives no information about the reason for the existence of the parameter.…

                        1 vote
                        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 →
                        • INPUTS and OUTPUTS section of get-help not displaying properly

                          Problem description
                          --------------------------
                          INPUTS and OUTPUTS section of get-help -Full content shows some unwanted tab and new line characters for almost all cmdlets.

                          For e.g.,

                          get-help content with INPUTS and OUTPUTS section highlighted where extra new line and tab comes for every cmdlet help content.


                          INPUTS
                          PSObject OR array of PSObject OR String OR array of String


                          You can pipe one IP address or a list of IP addresses as Strings, or one PSObject or list of PSObjects having
                          the iLO details such as IP Address, Hostname, Username and Password to access the iLO.


                          OUTPUTS



                          PSObject[] is returned. Use Get-Member…

                          1 vote
                          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 →
                          • 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 →
                            • 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 →
                              • 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 →
                                • 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 →
                                  • InformationVariable, InformationAction

                                    Add-Computer, Incorrect Help Info for parameters: InformationVariable, InformationAction

                                    It looks to me like the help documentation for these parameters may be wrong.

                                    -InformationAction [<System.Management.Automation.ActionPreference]>]

                                    Type the NetBIOS name, an Internet Protocol (IP) address, or a fully qualified domain name of each of the remote computers. To specify the local
                                    computer, type the computer name, a dot (.), or "localhost".

                                    This parameter does not rely on Windows PowerShell remoting. You can use the ComputerName parameter of Add-Computer even if your computer is not
                                    configured to run remote commands.
                                    This parameter is introduced in Windows PowerShell 3.0.

                                    Required? false
                                    Position? named
                                    Default…

                                    2 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 →
                                    • 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 Bug: Wrong Language + Wrong Locale + Wrong HelpInfoUri

                                        Documentation Bug: Wrong Language + Wrong Country + Wrong HelpInfoUri

                                        "Update-Help -Verbose -Force" gives:
                                        =============================
                                        Update-Help : Failed to update Help for the module(s)
                                        'Microsoft.PowerShell.Operation.Validation' with UI culture(s) {en-US} : The value of the
                                        HelpInfoUri key in the module manifest must resolve to a container or root URL on a website
                                        where the help files are stored. The HelpInfoUri 'https://www.msn.com/de-de/?ocid=NEFLS000';
                                        does not resolve to a container.
                                        At line:1 char:1
                                        + Update-Help -Verbose -Force
                                        + ~~~~~~~~~~~~~~~~~~~~~~~~~~~
                                        + CategoryInfo : InvalidOperation: (:) [Update-Help], Exception
                                        + FullyQualifiedErrorId : InvalidHelpInfoUri,Microsoft.PowerShell.Commands.UpdateHelpCommand
                                        ============================================

                                        But this is the current configuration:

                                        PS C:\WINDOWS\system32> $PSCulture
                                        en-US
                                        PS…

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

                                          Feedback and Knowledge Base