We're headed to GridSecCon 2024, October 22-25 in Minneapolis, MN! Learn more here

PowerShell PKI Module Documentation

Documentation Home

Get-ErrorMessage

Synopsis

Displays a human readable error message of Win32 and WinInet error codes

Syntax

Get-ErrorMessage [-ErrorCode] <Int32> [<CommonParameters>]

Description

Displays a human readable error message of Win32 and WinInet error codes. The command supports short and long error message notations. The commands support both, integer and hex (0x########) forms.

Parameters

-ErrorCode <Int32>

Specifies a Win32/WinInet error code. This parameter supports short and long error code notations.
Short notation: 5
Long notation as hex: 0x80070005
Long notation as integer: -2147024891

Required? True
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, InformationAction, InformationVariable,
WarningAction, WarningVariable, OutBuffer, PipelineVariable and OutVariable.
For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Inputs

System.Int32

Outputs

System.String

Notes

Examples

Example 1

PS C:\> Get-ErrorMessage 5

Displays a text associated with the Win32 error code 5 (Access denied) that is specified in a short notation.

Example 2

PS C:\> Get-ErrorMessage 0x80070005

Displays a text associated with the Win32 error code 0x8007005 (Access denied) that is specified as a hex.

Example 3

PS C:\> Get-ErrorMessage -2147024891

Displays a text associated with the Win32 error code -2147024891 (Access denied) that is specified as an integer.

Related links

Minimum PowerShell version support

  • Windows PowerShell 3.0

Operating System Support

  • Windows 7
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2008 R2 all editions
  • Windows Server 2012 all editions
  • Windows Server 2012 R2 all editions
  • Windows Server 2016 all editions
  • Windows Server 2019 all editions
  • Windows Server 2022 all editions