Obtener-AuthenticodeSignature (Microsoft.PowerShell.Security)

Get-AuthenticodeSignature

Módulo:

Microsoft.PowerShell.Security

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

Sintaxis

Get-AuthenticodeSignature
   [-FilePath] <String[]>
   [<CommonParameters>]

Get-AuthenticodeSignature
   -LiteralPath <String[]>
   [<CommonParameters>]

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

Descripción

Este cmdlet solo está disponible en la plataforma Windows.

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

Ejemplos

Ejemplo 1: obtener 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. Utiliza el parámetro FilePath para especificar el archivo.

Ejemplo 2: obtener 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 de Authenticode para los cuatro archivos enumerados en la línea de comando. 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 en el directorio $PSHOME que tienen una firma Authenticode válida. La variable automática $PSHOME contiene la ruta al directorio de instalación de PowerShell.

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

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

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

Ejemplo 4: obtener la firma Authenticode para el contenido de un 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, la extensión del archivo se especifica 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. Antes de PowerShell 7.4, el contenido del archivo debe estar en formato Unicode (UTF-16LE).

Tipo :

Byte[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-FilePath

Especifica la ruta al archivo a examinar. Se permiten comodines, pero deben conducir a un único archivo. No es necesario escribir FilePath en la línea de comando cuando especifica un valor para este parámetro.

Tipo :

String[]

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

True

-LiteralPath

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

Tipo :

String[]

Alias:

PSPath

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-SourcePathOrExtension

Ruta al archivo o tipo de archivo del contenido para el cual se recupera la firma Authenticode. Este parámetro se utiliza con Contenido donde el contenido del archivo se pasa como una matriz de bytes.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

Entradas

Cadena

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

Salidas

Firma

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

Notas

Este cmdlet solo está disponible en plataformas Windows.

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