Condividi tramite

Get-AuthenticodeSignature

  • Riferimento
Modulo:
Microsoft.PowerShell.Security

Ottiene informazioni sulla firma Authenticode per un file.

Sintassi

Get-AuthenticodeSignature
   [-FilePath] <String[]>
   [<CommonParameters>]
Get-AuthenticodeSignature
   -LiteralPath <String[]>
   [<CommonParameters>]
Get-AuthenticodeSignature
   -SourcePathOrExtension <String[]>
   -Content <Byte[]>
   [<CommonParameters>]

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il cmdlet Get-AuthenticodeSignature ottiene informazioni sulla firma Authenticode per un file o contenuto di file come matrice di byte. Se il file è sia firmato con segno che con il catalogo di Windows, viene usata la firma del catalogo di Windows. Se il file non è firmato, le informazioni vengono recuperate, ma i campi sono vuoti.

Esempio

Esempio 1: Ottenere la firma Authenticode per un file

Get-AuthenticodeSignature -FilePath "C:\Test\NewScript.ps1"

Questo comando ottiene informazioni sulla firma Authenticode nel file NewScript.ps1. Usa il parametro FilePath per specificare il file.

Esempio 2: Ottenere la firma Authenticode per più file

Get-AuthenticodeSignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1

Questo comando ottiene informazioni sulla firma Authenticode per i quattro file elencati nella riga di comando. In questo esempio viene omesso il nome del parametro FilePath, facoltativo.

Esempio 3: Ottenere solo firme Authenticode valide per più file

Get-ChildItem $PSHOME\*.* | ForEach-Object {Get-AuthenticodeSignature $_} |
    Where-Object {$_.Status -eq "Valid"}

Questo comando elenca tutti i file nella directory $PSHOME con una firma Authenticode valida. La variabile automatica $PSHOME contiene il percorso della directory di installazione di PowerShell.

Il comando usa il cmdlet Get-ChildItem per ottenere i file nella directory $PSHOME. Usa un modello di . escludere le directory (anche se esclude anche i file senza un punto nel nome file).

Il comando usa un operatore pipeline (|) per inviare i file in $PSHOME al cmdlet ForEach-Object, in cui Get-AuthenticodeSignature viene chiamato per ogni file.

I risultati del comando Get-AuthenticodeSignature vengono inviati a un comando Where-Object che seleziona solo gli oggetti firma con lo stato Valido.

Esempio 4: Ottenere la firma Authenticode per un contenuto di file specificato come matrice di byte

$authenticodeSignatureParams = @{
    Content = (Get-Content foo.ps1 -AsByteStream)
    SourcePathorExtension = "ps1"
}
Get-AuthenticodeSignature @authenticodeSignatureParams

Questo comando ottiene informazioni sulla firma Authenticode per il contenuto di un file. In questo esempio, l'estensione del file viene specificata insieme al contenuto del file.

Parametri

-Content

Contenuto di un file come matrice di byte per cui viene recuperata la firma Authenticode. Questo parametro deve essere usato con parametro SourcePathOrExtension. Prima di PowerShell 7.4, il contenuto del file deve essere in formato Unicode (UTF-16LE).

Tipo:Byte[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-FilePath

Specifica il percorso del file da esaminare. I caratteri jolly sono consentiti, ma devono portare a un singolo file. Non è necessario digitare FilePath nella riga di comando quando si specifica un valore per questo parametro.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-LiteralPath

Specifica il percorso del file da esaminare. A differenza di FilePath, il valore del parametro LiteralPath viene usato esattamente come viene digitato. Nessun carattere viene interpretato come caratteri jolly. Se il percorso include un carattere di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare i caratteri come caratteri di escape.

Tipo:String[]
Alias:PSPath, LP
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SourcePathOrExtension

Percorso del file o del tipo di file del contenuto per il quale viene recuperata la firma Authenticode. Questo parametro viene usato con Content in cui il contenuto del file viene passato come matrice di byte.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa contenente un percorso di file a questo cmdlet.

Output

Signature

Questo cmdlet restituisce un oggetto firma per ogni firma che ottiene.

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.

Per informazioni sulle firme Authenticode in PowerShell, vedere about_Signing.