Get-AuthenticodeSignature

  • Referencia
Módulo:
Microsoft.PowerShell.Security

Obtiene información sobre la firma Authenticode de un archivo.

Syntax

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Get-AuthenticodeSignature cmdlet obtiene información sobre la firma Authenticode para un archivo o contenido de archivo como una matriz de bytes. Si el archivo está firmado tanto con firma incrustada como con el catálogo de Windows, se usa la firma del catálogo de Windows. Si el archivo no está firmado, la información se recupera, pero los campos están en blanco.

Ejemplos

Ejemplo 1: Obtención de la firma Authenticode para un archivo

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

Este comando obtiene información sobre la firma Authenticode en el archivo NewScript.ps1. Usa el parámetro FilePath para especificar el archivo.

Ejemplo 2: Obtención de la firma Authenticode para varios archivos

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

Este comando obtiene información sobre la firma Authenticode para los cuatro archivos enumerados en la línea de comandos. En este ejemplo, se omite el nombre del parámetro FilePath , que es opcional.

Ejemplo 3: Obtener solo firmas authenticode válidas para varios archivos

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

Este comando enumera todos los archivos del $PSHOME directorio que tienen una firma Authenticode válida. La $PSHOME variable automática contiene la ruta de acceso al directorio de instalación de PowerShell.

El comando usa el Get-ChildItem cmdlet para obtener los archivos del $PSHOME directorio. Usa un patrón de . para excluir directorios (aunque también excluye archivos sin un punto en el nombre de archivo).

El comando usa un operador de canalización (|) para enviar los archivos al ForEach-Object$PSHOME cmdlet , donde Get-AuthenticodeSignature se llama a para cada archivo.

Los resultados del Get-AuthenticodeSignature comando se envían a un Where-Object comando que selecciona solo los objetos de firma con un estado Válido.

Ejemplo 4: Obtención de la firma Authenticode para un contenido de archivo especificado como matriz de bytes

Get-AuthenticodeSignature -Content (Get-Content foo.ps1 -AsByteStream) -SourcePathorExtension ps1

Este comando obtiene información sobre la firma Authenticode para el contenido de un archivo. En este ejemplo, se especifica la extensión de archivo junto con el contenido del archivo.

Parámetros

-Content

Contenido de un archivo como una matriz de bytes para la que se recupera la firma Authenticode. Este parámetro debe usarse con el parámetro SourcePathOrExtension . El contenido del archivo debe estar en formato Unicode (UTF-16LE).

Type:Byte[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-FilePath

Especifica la ruta de acceso al archivo que se va a examinar. Se permite el uso de caracteres comodín, pero deben conducir a un único archivo. No es necesario escribir FilePath en la línea de comandos cuando se especifica un valor para este parámetro.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-LiteralPath

Especifica la ruta de acceso al archivo que se está examinando. A diferencia de FilePath, el valor del parámetro LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye un carácter de escape, escríbalo entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como caracteres de escape.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourcePathOrExtension

Ruta de acceso al archivo o tipo de archivo del contenido para el que se recupera la firma Authenticode. Este parámetro se usa con Content donde se pasa contenido de archivo como una matriz de bytes.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso de archivo a este cmdlet.

Salidas

Signature

Este cmdlet devuelve un objeto de firma para cada firma que obtiene.

Notas

Este cmdlet solo está disponible en plataformas Windows.

Para obtener información sobre las firmas Authenticode en PowerShell, consulte about_Signing.