Get-PfxCertificate
Получает сведения о файлах сертификатов PFX на компьютере.
Синтаксис
ByPath (по умолчанию)
Get-PfxCertificate
[-FilePath] <String[]>
[-Password <SecureString>]
[-NoPromptForPassword]
[<CommonParameters>]
ByLiteralPath
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-файл сертификата не защищен паролем, значение параметра проверки подлинности для Invoke-Command должно быть CredSSP.
Параметры
-FilePath
Указывает полный путь к PFX-файлу защищенного файла. Если указать значение для этого параметра, не нужно вводить -FilePath в командной строке.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByPath
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-LiteralPath
Полный путь к PFX-файлу защищенного файла. В отличие от FilePath, значение параметра LiteralPath используется точно так, как введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки указывают PowerShell на то, что не следует интерпретировать какие-либо символы как управляющие последовательности.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | PSPath, LP |
Наборы параметров
ByLiteralPath
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-NoPromptForPassword
Подавляет запрос на ввод пароля.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Password
Указывает пароль, необходимый для доступа к файлу сертификата .pfx.
Этот параметр появился в PowerShell 6.1.
Замечание
Дополнительные сведения о защите данных SecureString см. в разделе Как безопасно SecureString?.
Свойства параметра
| Тип: | SecureString |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
Можно передать строку, содержащую путь к файлу Get-PfxCertificate.
Выходные данные
X509Certificate2
Get-PfxCertificate возвращает объект для каждого сертификата, который он получает.
Примечания
При использовании командлета Invoke-Command для удаленного выполнения команды Get-PfxCertificate, если файл сертификата PFX не защищен паролем, значение параметра аутентификации Invoke-Command должно быть CredSSP.
