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>]
ByContent
Get-AuthenticodeSignature
-SourcePathOrExtension <String[]>
-Content <Byte[]>
[<CommonParameters>]
Description
Este cmdlet só está disponível na plataforma Windows.
O cmdlet Get-AuthenticodeSignature obtém informações sobre a assinatura Authenticode para um arquivo ou conteúdo de arquivo como uma matriz de bytes.
Se o ficheiro estiver assinado tanto incorporado como no catálogo do Windows, a assinatura do catálogo do Windows será usada.
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.
Exemplo 4: Obter a assinatura Authenticode para um conteúdo de arquivo especificado como matriz de bytes
Get-AuthenticodeSignature -Content (Get-Content foo.ps1 -AsByteStream) -SourcePathorExtension ps1
Este comando obtém informações sobre a assinatura Authenticode para o conteúdo de um arquivo. Neste exemplo, a extensão do arquivo é especificada junto com o conteúdo do arquivo.
Parâmetros
-Content
Conteúdo de um arquivo como uma matriz de bytes para a qual a assinatura Authenticode é recuperada. Este parâmetro deve ser usado com SourcePathOrExtension parâmetro. O conteúdo do arquivo deve estar no formato Unicode (UTF-16LE).
Propriedades dos parâmetros
| Tipo: | Byte[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByContent
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-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 |
-SourcePathOrExtension
Caminho para o arquivo ou tipo de arquivo do conteúdo para o qual a assinatura Authenticode é recuperada. Este parâmetro é usado com Content onde o conteúdo do arquivo é passado como uma matriz de bytes.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByContent
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| 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 redirecionar 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
Este cmdlet só está disponível em plataformas Windows.
Para obter informações sobre assinaturas Authenticode no PowerShell, consulte about_Signing.