Get-AuthenticodeSignature
Obtém informações sobre a assinatura Authenticode para um arquivo.
Sintaxe
ByPath (Predefinição)
Get-AuthenticodeSignature
[-FilePath] <String[]>
[<CommonParameters>]
ByLiteralPath
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.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByPath
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-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 carta curinga. Se o caminho incluir um caractere de escape, coloque-o entre aspas simples. As aspas simples instruem o PowerShell para não interpretar quaisquer caracteres como caracteres de escape.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
ByLiteralPath
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
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.