Compartir a través de

Get-AuthenticodeSignature

Módulo:
Microsoft.PowerShell.Security Module

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

Sintaxis

ByPath (valor predeterminado) 

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

ByLiteralPath 

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

Description

El cmdlet Get-AuthenticodeSignature obtiene información sobre la firma Authenticode de un archivo. Si el archivo no está firmado, se recupera la información, 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 directorio $PSHOME que tienen una firma Authenticode válida. La variable automática $PSHOME contiene la ruta de acceso al directorio de instalación de PowerShell.

El comando usa el cmdlet Get-ChildItem para obtener los archivos del directorio $PSHOME. Usa un patrón de . 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 de $PSHOME al cmdlet ForEach-Object, donde se llama a Get-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.

Parámetros

-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 al especificar un valor para este parámetro.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

ByPath
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-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.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PSPath

Conjuntos de parámetros

ByLiteralPath
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso de archivo a Get-AuthenticodeSignature.

Salidas

Signature

get-AuthenticodeSignature devuelve un objeto de firma para cada firma que obtiene.

Notas

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