Get-PfxCertificate
Obtém informações sobre arquivos de certificado PFX no computador.
Sintaxe
ByPath (Predefinição)
Get-PfxCertificate
[-FilePath] <String[]>
[-Password <SecureString>]
[-NoPromptForPassword]
[<CommonParameters>]
ByLiteralPath
Get-PfxCertificate
-LiteralPath <String[]>
[-Password <SecureString>]
[-NoPromptForPassword]
[<CommonParameters>]
Description
O cmdlet Get-PfxCertificate obtém um objeto que representa cada arquivo de certificado PFX especificado.
Um arquivo PFX inclui o certificado e uma chave privada.
Exemplos
Exemplo 1: Obter um certificado PFX
Get-PfxCertificate -FilePath "C:\windows\system32\Test.pfx"
Password: ******
Signer Certificate: David Chew (Self Certificate)
Time Certificate:
Time Stamp:
Path: C:\windows\system32\zap.pfx
Este comando obtém informações sobre o arquivo de certificado Test.pfx no sistema.
Exemplo 2: Obter um certificado PFX de um computador remoto
Invoke-Command -ComputerName "Server01" -ScriptBlock {Get-PfxCertificate -FilePath "C:\Text\TestNoPassword.pfx"} -Authentication CredSSP
Este comando obtém um arquivo de certificado PFX do computador remoto Server01. Ele usa Invoke-Command para executar um comando Get-PfxCertificate remotamente.
Quando o arquivo de certificado PFX não está protegido por senha, o valor do parâmetro Authentication de Invoke-Command deve ser CredSSP.
Parâmetros
-FilePath
Especifica o caminho completo para o arquivo PFX do arquivo seguro. Se você especificar um valor para esse parâmetro, não será necessário digitar -FilePath na linha de comando.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| 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
O caminho completo para o ficheiro PFX do ficheiro protegido. Ao contrário FilePath, o valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath, LP |
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 |
-NoPromptForPassword
Suprime a solicitação de uma senha.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Password
Especifica uma senha necessária para acessar um arquivo de certificado .pfx.
Esse parâmetro foi introduzido no PowerShell 6.1.
Observação
Para obter mais informações sobre SecureString proteção de dados, consulte Quão seguro é o SecureString?.
Propriedades dos parâmetros
| Tipo: | SecureString |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| 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-PfxCertificate.
Saídas
X509Certificate2
Get-PfxCertificate retorna um objeto para cada certificado obtido.
Notas
Ao usar o cmdlet Invoke-Command para executar um comando Get-PfxCertificate remotamente e o arquivo de certificado PFX não estiver protegido por senha, o valor do parâmetro Authentication de Invoke-Command deve ser CredSSP.
