Get-PfxCertificate (Microsoft.PowerShell.Security)

Get-PfxCertificate

Модуль:: Microsoft.PowerShell.Security

Получает информацию о файлах сертификатов PFX на компьютере.

Синтаксис

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

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

Описание

Командлет Get-PfxCertificate получает объект, представляющий каждый указанный файл сертификата 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

Эта команда получает файл сертификата PFX с удаленного компьютера Server01. Он использует Invoke-Command для удаленного запуска команды Get-PfxCertificate.

Если файл сертификата PFX не защищен паролем, значение параметра Authentication Invoke-Command должно быть CredSSP.

Параметры

-FilePath

Указывает полный путь к файлу PFX защищенного файла. Если вы укажете значение для этого параметра, нет необходимости вводить -FilePath в командной строке.

Тип :: String[]
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-LiteralPath

Полный путь к PFX-файлу защищенного файла. В отличие от FilePath, значение параметра LiteralPath используется точно так, как оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки сообщают PowerShell не интерпретировать никакие символы как escape-последовательности.

Тип :: String[]
Псевдонимы:: PSPath
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-NoPromptForPassword

Подавляет запрос пароля.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Password

Указывает пароль, необходимый для доступа к файлу сертификата .pfx.

Этот параметр был введен в PowerShell 6.1.

Примечание

Дополнительную информацию о защите данных SecureString см. в разделе Насколько безопасен SecureString?

Тип :: SecureString
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

Вы можете передать строку, содержащую путь к файлу, в Get-PfxCertificate.

Выходы

X509Certificate2

Get-PfxCertificate возвращает объект для каждого полученного сертификата.

Примечания

При использовании командлета Invoke-Command для удаленного запуска команды Get-PfxCertificate и файл сертификата PFX не защищен паролем, значение Authentication параметр Invoke-Command должен быть CredSSP.