powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Get-AuthenticodeSignature



NAME
Get-AuthenticodeSignature

SYNOPSIS
Gets information about the Authenticode signature in a file.

SYNTAX
Get-AuthenticodeSignature [-FilePath] []


DESCRIPTION
The Get-AuthenticodeSignature cmdlet gets information about the Authenticode signature in a file. If the file is no
t signed, the information is retrieved, but the fields are blank.


PARAMETERS
-FilePath
Specifies the path to the file being examined. Wildcards are permitted, but they must lead to a single file. Th
e parameter name ("FilePath") is optional.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS
System.String
You can pipe a string that contains a file path to Get-AuthenticodeSignature.


OUTPUTS
System.Management.Automation.Signature
Get-AuthenticodeSignature returns a signature object for each signature that it gets.


NOTES


For information about Authenticode signatures in Windows PowerShell, see about_Signing.


-------------------------- EXAMPLE 1 --------------------------

C:\PS>get-AuthenticodeSignature -filepath C:\Test\NewScript.ps1


Description
-----------
This command gets information about the Authenticode signature in the NewScript.ps1 file. It uses the FilePath para
meter to specify the file.





-------------------------- EXAMPLE 2 --------------------------

C:\PS>get-authenticodesignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1


Description
-----------
This command gets information about the Authenticode signature in the four files listed at the command line. In thi
s command, the name of the FilePath parameter, which is optional, is omitted.





-------------------------- EXAMPLE 3 --------------------------

C:\PS>get-childitem $pshome\*.* | foreach-object {Get-AuthenticodeSignature $_} | where {$_.status -eq "Valid"}


Description
-----------
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 ex
clude 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-Authe
nticodeSignature is called for each file.

The results of the Get-AuthenticodeSignature command are sent to a Where-Object command that selects only the signa
ture objects with a status of "Valid".






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113307
about_Signing
about_Execution_Policies
Set-AuthenticodeSignature
Get-ExecutionPolicy
Set-ExecutionPolicy