Skip to content

Update-Help fails silently for UICulture en-GB #17696

@dkaszews

Description

@dkaszews

Prerequisites

Steps to reproduce

Help pages for about_topics are missing and cannot be downloaded on en-GB locale. Verbose output shows only redirects and zero downloads. Issue can be fixed by passing -UICulture en-US to Update-Help. I understand that the help pages are set to specific locale, but if it causes them to be completely missing in a different locale of same language, it's a bad user experience. Either show a warning "Help pages for UICulture en-GB not found, but available in en-US, try calling with -UICulture en-US", or just download them automatically. Get-Help already works with partial locale matches, just Update-Help needs fixing.

> Get-UICulture
LCID             Name             DisplayName
----             ----             -----------
2057             en-GB            English (United Kingdom)
> Update-Help -Force -Verbose

Expected behavior

> Get-Help about_operators
ABOUT_OPERATORS
Short description
Describes the operators that are supported by PowerShell.

Actual behavior

> Get-Help about_operators
Get-Help: Get-Help could not find about_operators in a help file in this session. To download updated help topics type: "Update-Help". To get help online, search for the help topic in the TechNet library at https://go.microsoft.com/fwlink/?LinkID=107116.

Error details

> get-error
Exception             :
    Type        : Microsoft.PowerShell.Commands.HelpNotFoundException
    ErrorRecord :
        Exception             :
            Type    : System.Management.Automation.ParentContainsErrorRecordException
            Message : Get-Help could not find about_operators in a help file in this session.
To download updated help topics type: "Update-Help". To get help online, search for the help
topic in the TechNet library at https://go.microsoft.com/fwlink/?LinkID=107116.
            HResult : -2146233087
        CategoryInfo          : ResourceUnavailable: (:) [],
ParentContainsErrorRecordException
        FullyQualifiedErrorId : HelpNotFound
        ErrorDetails          :
    HelpTopic   : about_operators
    Message     : Get-Help could not find about_operators in a help file in this session. To
download updated help topics type: "Update-Help". To get help online, search for the help
topic in the TechNet library at https://go.microsoft.com/fwlink/?LinkID=107116.
    HResult     : -2146233087
CategoryInfo          : ResourceUnavailable: (:) [Get-Help], HelpNotFoundException
FullyQualifiedErrorId : HelpNotFound,Microsoft.PowerShell.Commands.GetHelpCommand
InvocationInfo        :
    MyCommand        : Get-Help
    ScriptLineNumber : 1
    OffsetInLine     : 1
    HistoryId        : 8
    Line             : get-help about_operators
    PositionMessage  : At line:1 char:1
                       + get-help about_operators
                       + ~~~~~~~~~~~~~~~~~~~~~~~~
    InvocationName   : get-help
    CommandOrigin    : Internal
ScriptStackTrace      : at <ScriptBlock>, <No file>: line 1
PipelineIterationInfo :

Environment data

> $PSVersionTable
Name                           Value
----                           -----
PSVersion                      7.3.0-preview.5
PSEdition                      Core
GitCommitId                    7.3.0-preview.5
OS                             Linux 5.15.0-1011-raspi #13-Ubuntu SMP PREEMPT Thu Jun 2 11:44…
Platform                       Unix
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

Visuals

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions