liveBook · Manning

Help file

As explained in Learn PowerShell in a Month of Lunches: Fourth Edition, Covers Windows, Linux, and macOS

A cmdlet help file is a documentation file that describes a PowerShell cmdlet, including its syntax, parameters, and behavior.

A PowerShell help file documents a cmdlet and provides the information needed to use it effectively. Its conventions help you read syntax, parameters, behavior, aliases, remarks, and examples. section 3.5 section 3.2

Use help files to:

  • Check a cmdlet's syntax and available parameters before running it. section 3.5 section 3.2
  • Read examples rather than searching elsewhere first; every displayed detail may clarify how a command works. section 9.4
  • Update local documentation with Update-Help, or save it with Save-Help for computers without internet access. section 3.2
  • Compare local information with Microsoft Docs by adding -Online when online help is available. section 3.7

Open online help

Run `Help Get-Item -Online` to open the web-based help in a browser. For a fuller local topic, run `Update-Help` first, then inspect the command's syntax and examples. section 3.7 section 3.2

PS /User/travisp> help Get-Process
NAME
    Get-Process
 
SYNTAX
    Get-Process [[-Name] <string[]>] [-Module] [-FileVersionInfo]
    [<CommonParameters>]
 
    Get-Process [[-Name] <string[]>] -IncludeUserName [<CommonParameters>]
 
    Get-Process -Id <int[]> -IncludeUserName [<CommonParameters>]
 
    Get-Process -Id <int[]> [-Module] [-FileVersionInfo] [<CommonParameters>]
 
    Get-Process -InputObject <Process[]> [-Module] [-FileVersionInfo]
    [<CommonParameters>]
 
    Get-Process -InputObject <Process[]> -IncludeUserName 
   [<CommonParameters>]
 
 
ALIASES
    gps
 
 
REMARKS
    Get-Help cannot find the Help files for this cmdlet on this computer. It
    is displaying only partial help.
        -- To download and install Help files for the module that includes
    this cmdlet, use Update-Help.
        -- To view the Help topic for this cmdlet online, type: "Get-Help
    Get-Process -Online" or
           go to https://go.microsoft.com/fwlink/?LinkID=113324.

A sample Get-Process topic shows the compact format of a help file, including syntax, aliases, and remarks about missing local content. section 3.2

How Learn PowerShell in a Month of Lunches: Fourth Edition, Covers Windows, Linux, and macOS covers it

How deep it goes
Explains help-file conventions and maintenance procedures, but stops short of detailing every documentation section or cmdlet behavior.
Examples
Uses Get-Item -Online, Get-Process help output, Update-Help, and Save-Help as practical documentation examples.
What it assumes
Assumes basic ability to open PowerShell and run commands while teaching help interpretation and updating from the beginning.
What you can do after
Evaluate cmdlet syntax and examples, access current documentation, and prepare help for offline computers.
How it connects
Connects cmdlets with syntax, parameters, aliases, modules, online help, and the PowerShell help system.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Learn PowerShell in a Month of Lunches: Fourth Edition, Covers Windows, Linux, and macOS. The section links point to the parts of the book it draws on.