This is the built-in help made by Microsoft for the command 'Get-AuthenticodeSignature', in PowerShell version 5 - as retrieved from
Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Gets information about the Authenticode signature in a file.
Get-AuthenticodeSignature [-FilePath] <String[]> [<CommonParameters>]
Get-AuthenticodeSignature -LiteralPath <String[]> [<CommonParameters>]
The Get-AuthenticodeSignature cmdlet gets information about the Authenticode signature in a file. If the file is not signed, the information is retrieved, but the fields are
blank.
<
Online Version: http://go.microsoft.com/fwlink/p/?linkid=293935
Get-ExecutionPolicy
Set-AuthenticodeSignature
Set-ExecutionPolicy
about_Execution_Policies
about_Signing
<
-------------------------- EXAMPLE 1 --------------------------
PS C:\>get-AuthenticodeSignature -filepath C:\Test\NewScript.ps1
This command gets information about the Authenticode signature in the NewScript.ps1 file. It uses the FilePath parameter to specify the file.
-------------------------- EXAMPLE 2 --------------------------
PS C:\>get-authenticodesignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1
This command gets information about the Authenticode signature in the four files listed at the command line. In this command, the name of the FilePath parameter, which is
optional, is omitted.
-------------------------- EXAMPLE 3 --------------------------
PS C:\>get-childitem $pshome\*.* | foreach-object {Get-AuthenticodeSignature $_} | where {$_.status -eq "Valid"}
This command lists all of the files in the $pshome directory that have a valid Authenticode signature. The $pshome automatic variable contains the path to the Windows
PowerShell installation directory.
The command uses the Get-ChildItem cmdlet to get the files in the $pshome directory. It uses a pattern of *.* to exclude directories (although it also excludes files without
a dot in the filename).
The command uses a pipeline operator (|) to send the files in $pshome to the Foreach-Object cmdlet, where Get-AuthenticodeSignature is called for each file.
The results of the Get-AuthenticodeSignature command are sent to a Where-Object command that selects only the signature objects with a status of "Valid".