Obtiene información sobre la firma Authenticode en un archivo.
Sintaxis
Get-AuthenticodeSignature [-FilePath] <string[]> [<CommonParameters>]
Descripción
El cmdlet Get-AuthenticodeSignature obtiene información sobre la firma Authenticode de un archivo. Si el archivo no está firmado, la información se recupera pero los campos estarán vacíos.
Parámetros
-FilePath <string[]>
Especifica la ruta de acceso al archivo que se va a examinar. Se permite el uso de caracteres comodín, pero deben llevar a un único archivo. El nombre del parámetro ("FilePath") es opcional.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.String Se puede canalizar a Get-AuthenticodeSignature una cadena que contenga una ruta de acceso a un archivo. |
|
Salidas |
System.Management.Automation.Signature Get-AuthenticodeSignature devuelve un objeto de firma por cada firma que obtiene. |
Notas
Para obtener información acerca de las firmas Authenticode en Windows PowerShell, vea about_Signing.
Ejemplo 1
C:\PS>get-AuthenticodeSignature -filepath C:\Test\NewScript.ps1 Descripción ----------- 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
C:\PS>get-authenticodesignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1 Descripción ----------- Este comando obtiene información sobre la firma Authenticode en los cuatro archivos enumerados en la línea de comandos. En este comando se omite el nombre del parámetro FilePath, que es opcional.
Ejemplo 3
C:\PS>get-childitem $pshome\*.* | foreach-object {Get-AuthenticodeSignature $_} | where {$_.status -eq "Valid"}
Descripción
-----------
Este comando muestra 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 Windows PowerShell.
El comando utiliza el cmdlet Get-ChildItem para obtener los archivos del directorio $pshome. Utiliza un patrón *. * para excluir directorios (aunque también excluye los archivos sin un punto en el nombre de archivo).
El comando utiliza 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 el estado "Valid".
Vea también