Get-AuthenticodeSignature

Artigo
10/30/2009

Obtém informações sobre a assinatura Authenticode em um arquivo.

Sintaxe

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

Descrição

O cmdlet Get-AuthenticodeSignature obtém informações sobre a assinatura Authenticode em um arquivo. Se o arquivo não estiver assinado, as informações serão recuperadas, mas os campos estarão em branco.

Parâmetros

-FilePath <string[]>

Especifica o caminho para o arquivo que está sendo examinado. Caracteres curinga são permitidos, mas eles devem levar a um arquivo único. O nome do parâmetro ("FilePath") é opcional.

Necessário?	true
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	true (ByValue, ByPropertyName)
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.String

Você pode enviar uma cadeia de caracteres que contém um caminho de arquivo para Get-AuthenticodeSignature.

Saídas

System.Management.Automation.Signature

Get-AuthenticodeSignature retorna um objeto de assinatura para cada assinatura obtida.

Observações

Para obter informações sobre assinaturas Authenticode no Windows PowerShell, consulte about_Signing.

Exemplo 1

C:\PS>get-AuthenticodeSignature -filepath C:\Test\NewScript.ps1

Descrição
-----------
Esse comando obtém informações sobre a assinatura Authenticode no arquivo NewScript.ps1. Ele usa o parâmetro FilePath para especificar o arquivo.

Exemplo 2

C:\PS>get-authenticodesignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1

Descrição
-----------
Esse comando obtém informações sobre a assinatura Authenticode nos quatro arquivos listados na linha de comando. Nesse comando, o nome do parâmetro FilePath, que é opcional, foi omitido.

Exemplo 3

C:\PS>get-childitem $pshome\*.* | foreach-object {Get-AuthenticodeSignature $_} | where {$_.status -eq "Valid"}

Descrição
-----------
Esse comando lista todos os arquivos no diretório $pshome que possuem uma assinatura Authenticode válida. A variável automática $pshome contém o caminho para o diretório de instalação do Windows PowerShell.

O comando usa o cmdlet Get-ChildItem para obter os arquivos no diretório $pshome. Ele usa o padrão *.* para excluir diretórios (embora também exclua arquivos sem um ponto no nome de arquivo).

O comando usa um operador de pipeline (|) para enviar os arquivos em $pshome para o cmdlet Foreach-Object, em que Get-AuthenticodeSignature é chamado para cada arquivo. 

Os resultados do comando Get-AuthenticodeSignature são enviados para um comando Where-Object que seleciona apenas os objetos de assinatura com o status de "Válido".

Consulte também

Conceitos

about_Signing
about_Execution_Policies
Set-AuthenticodeSignature
Get-ExecutionPolicy
Set-ExecutionPolicy

Compartilhar via