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.
  • Hot ideas
  • Top ideas
  • New ideas
  • My feedback
  1. 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…

    5 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  2. 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  3. 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    2 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  4. 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  5. 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?

    4 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  6. 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  7. 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  8. 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  9. 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.

    aboutActivityCommonParameters.help.txt
    about
    ActivityCommonParameters.txt
    aboutCheckpoint-Workflow.help.txt
    about
    Checkpoint-Workflow.txt
    aboutForeach-Parallel.help.txt
    about
    Foreach-Parallel.txt
    aboutInlineScript.help.txt
    about
    InlineScript.txt
    aboutParallel.help.txt
    about
    Parallel.txt
    aboutSequence.help.txt
    about
    Sequence.txt
    aboutSuspend-Workflow.help.txt
    about
    Suspend-Workflow.txt …

    17 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    survey  ·  3 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  10. 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 to
    1 vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  11. Register-ArgumentCompleter is not documented

    The cmdlet Register-ArgumentCompleter is not documented.

    4 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    survey  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  12. 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 &quot;localhost&quot;.

    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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  13. 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&#39;
    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 C:\WINDOWS\system32>…

    2 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  14. Help for FileSystem dynamic parameters of Get-ChildItem are broken

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

    PS C:&gt; (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:&gt; $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:&gt;…

    4 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    investigating  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  15. 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>&lt;cmdletHelpPaths> section of Microsoft.PowerShell.Security.dll-help.xml.

    5 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    investigating  ·  1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  16. 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>&lt;cmdletHelpPaths> element of the help XML file.

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

    PS C:&gt; (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:&gt; (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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    investigating  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  17. Get-Help should process Alias parameter attribute in MAML help

    A parameter definition in the PowerShell MAML file allows an aliases attribute to be defined. However, when executing Get-Help -Full or Get-Help -Parameter, the table the Help Engine displays does not contain the Aliases row. If I remove reference to the ExternalHelp comment tag in a Cmdlet (within a PSM1), Get-Help will display the Aliases row. Comment-based or MAML help will not display the Aliases row.

    2 votes
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    investigating  ·  1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  18. CheckPoint-Workflow points to non-existent help for how to checkpoint

    At the bottom, this URL goes to a "This topic is no longer available":

    SEE ALSO

    How to Add Checkpoints to a Workflow (<a rel="nofollow noreferrer" href="http://go.microsoft.com/fwlink/?LinkId=261993">http://go.microsoft.com/fwlink/?LinkId=261993</a>)
    

    1 vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    survey  ·  1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  19. about_Language_Keywords is missing 4.0-5.0 keywords

    aboutLanguageKeywords 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    survey  ·  1 comment  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  20. 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
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)

    We’ll send you updates on this idea

    survey  ·  0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
  • Don't see your idea?

Feedback and Knowledge Base