How to enable Updatable Help for your PowerShell Module

PowerShell Team

PowerShell Team

PowerShell 3.0 lets the user update Help content on a per module basis. In this article, I will explain how you can enable this for your own PowerShell module.

Prerequisites: Have a new (script/binary) module, help content for the cmdlets of the module, and a server where the help content is located. For this particular exercise I will be using a script module.

Here is how my module is organized:



TestModule.psm1 is my script module. There, I defined the name of help file.

TestModule.psd1 is the module manifest for my module. The HelpInfoURI field is the address where the help content for this module is located.

On the server site, we have:

  • The .cab file which contains the dll-Help.xml or the psm1-Help.xml file
  • The HelpInfo.xml file.

The .cab file must be named as follows:



ModuleName: The name of the module (same as the module manifest file).

ModuleGUID: The module GUID as referenced in the module manifest.

UI-Culture: The four letter hyphenated UI culture abbreviation (en-US, fr-FR, de-DE, etc.).

HelpContent: Indicates that this cab contains the help content file.

For example:

Similarly, the HelpInfo file must adhere to the following naming convention:



ModuleName: Name of the module (same as the module manifest file).

ModuleGUID: Module GUID as referenced in the module manifest.

HelpInfo: Indicates that this is the help info file.

For example:


File content of the HelpInfo.xml file:

<?xml version="1.0" encoding="utf-8"?>

<HelpInfo xmlns="">









Note: The HelpContentURI (in yellow) should point to a container.

Place these two files in the server folder PSHelpContent, e.g., \\mysite\c$\Inetpub\wwwroot\PSHelpContent\

How to Test Updatable Help for Your Module

# First, make sure updatable help works using the -SourcePath

Update-Help -Module TestModule -SourcePath \\mysite\c$\Inetpub\wwwroot\PSHelpContent\ -Force


# After that, you can use without the -SourcePath which will connect to the site defined in 

# the module manifest, HelpInfoURI = ‘’

Update-Help -Module TestModule -Force

For more information on Supporting Updatable Help, please visit


Francisco Gamino

PowerShell Test Team


Comments are closed.