Partilhar via

Get-AuthenticodeSignature

  • Referência
Módulo:
Microsoft.PowerShell.Security

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

Sintaxe

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

Description

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

Exemplos

Exemplo 1: Obter a assinatura Authenticode para um arquivo

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

Este 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: Obter a assinatura Authenticode para vários arquivos

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

Este comando obtém informações sobre a assinatura Authenticode para os quatro arquivos listados na linha de comando. Neste exemplo, o nome do parâmetro FilePath, que é opcional, é omitido.

Exemplo 3: Obter apenas assinaturas Authenticode válidas para vários arquivos

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

Este comando lista todos os arquivos no diretório $PSHOME que têm uma assinatura Authenticode válida. A variável automática $PSHOME contém o caminho para o diretório de instalação do PowerShell.

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

O comando usa um operador de pipeline (|) para enviar os arquivos em $PSHOME para o cmdlet ForEach-Object, onde 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 um status de Válido.

Parâmetros

-FilePath

Especifica o caminho para o arquivo a ser examinado. Curingas são permitidos, mas eles devem levar a um único arquivo. Não é necessário digitar -FilePath na linha de comando quando você especifica um valor para esse parâmetro.

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-LiteralPath

Especifica o caminho para o arquivo que está sendo examinado. Ao contrário FilePath, o valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como curinga. Se o caminho incluir um caractere de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como caracteres de escape.

Tipo:String[]
Aliases:PSPath
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

String

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

Saídas

Signature

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

Notas

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