Compartilhar 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 ficarão em branco.

Exemplos

Exemplo 1: Obter a assinatura authenticode para um arquivo

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

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

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

Esse 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 somente assinaturas válidas do Authenticode para vários arquivos

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

Esse comando lista todos os arquivos no diretório $PSHOME que têm uma assinatura válida do Authenticode. A variável $PSHOME automática 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 . 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, 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 um status de Valid.

Parâmetros

-FilePath

Especifica o caminho para o arquivo a ser examinado. Curingas são permitidos, mas 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[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-LiteralPath

Especifica o caminho para o arquivo que está sendo examinado. Ao contrário de FilePath, o valor do parâmetro LiteralPath é usado exatamente como ele é 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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 que obtém.

Observações

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