Get-PfxCertificate

获取有关计算机上的 PFX 证书文件的信息。

语法

ByPath (默认值)

Get-PfxCertificate
    [-FilePath] <String[]>
    [-Password <SecureString>]
    [-NoPromptForPassword]
    [<CommonParameters>]

ByLiteralPath

Get-PfxCertificate
    -LiteralPath <String[]>
    [-Password <SecureString>]
    [-NoPromptForPassword]
    [<CommonParameters>]

说明

Get-PfxCertificate cmdlet 获取一个对象,该对象表示每个指定的 PFX 证书文件。 PFX 文件包括证书和私钥。

示例

示例 1:获取 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

此命令获取有关系统上 Test.pfx 证书文件的信息。

示例 2:从远程计算机获取 PFX 证书

Invoke-Command -ComputerName "Server01" -ScriptBlock {Get-PfxCertificate -FilePath "C:\Text\TestNoPassword.pfx"} -Authentication CredSSP

此命令从 Server01 远程计算机获取 PFX 证书文件。 它使用 Invoke-Command 远程运行 Get-PfxCertificate 命令。

当 PFX 证书文件不受密码保护时,身份验证Invoke-Command 参数的值必须为 CredSSP。

参数

-FilePath

指定受保护文件的 PFX 文件的完整路径。 如果为此参数指定值,则无需在命令行键入 -FilePath

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ByPath
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-LiteralPath

受保护文件的 PFX 文件的完整路径。 与 FilePath不同,LiteralPath 参数的值被按其键入的形式使用。 不会将任何字符解释为通配符。 如果路径包含转义字符,请将它括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False
别名:PSPath, LP

参数集

ByLiteralPath
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-NoPromptForPassword

禁止提示输入密码。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Password

指定访问 .pfx 证书文件所需的密码。

此参数是在 PowerShell 6.1 中引入的。

注释

有关 SecureString 数据保护的详细信息,请参阅 SecureString 的安全性如何?

参数属性

类型:SecureString
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

可以通过管道将包含文件路径的字符串传递给 Get-PfxCertificate

输出

X509Certificate2

Get-PfxCertificate 为它获取的每个证书返回一个对象。

备注

使用 Invoke-Command cmdlet 远程运行 Get-PfxCertificate 命令并且 PFX 证书文件不受密码保护时,Invoke-Command 参数的值必须是 CredSSP。