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. get-help output

    In the output of get-help the examples are listed and there are no lines separating examples from the end of the previous description. This is very confusing and difficult to read.
    Just an extra line between the end of the description of the example and the next example would make a huge difference.
    eg:

    Example 1: Apply configuration settings

    PS C:\> Start-DscConfiguration -Path "C:\DSC\Configurations\"
    
    

    This command applies the configuration settings from C:\DSC\Configurations\ to the every computer that has settings in that folder. The
    command returns Job objects for each target node deployed to.

    [put a break here] Example 2: Apply…

    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 →
  2. 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
    (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 →
  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. 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?

    3 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 →
  5. 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 →
  6. 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 →
  7. 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 →
  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. 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 →
  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. 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 →
  12. 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 →
  13. 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 →
  14. 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 →
  15. 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 →
  16. 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 →
  17. 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 →
  18. 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 →
  19. 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 →
  20. 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 →
  • Don't see your idea?

Feedback and Knowledge Base