Export-ExchangeCertificate

Синтаксис

Thumbprint

Export-ExchangeCertificate
    [-Thumbprint] <String>
    [-Server <ServerIdParameter>]
    [-BinaryEncoded]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-FileName <String>]
    [-Password <SecureString>]
    [-WhatIf]
    [<CommonParameters>]

Identity

Export-ExchangeCertificate
    [[-Identity] <ExchangeCertificateIdParameter>]
    [-BinaryEncoded]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-FileName <String>]
    [-Password <SecureString>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Примеры

Пример 1

Export-ExchangeCertificate -Thumbprint 5113ae0233a72fccb75b1d0198628675333d010e -FileName "C:\Data\HT cert.pfx" -BinaryEncoded -Password (Get-Credential).password

Пример 2

$bincert = Export-ExchangeCertificate -Thumbprint 5113ae0233a72fccb75b1d0198628675333d010e -BinaryEncoded -Password (Get-Credential).password

[System.IO.File]::WriteAllBytes('C:\Data\HT cert.pfx', $bincert.FileData)

Пример 3

Export-ExchangeCertificate -Thumbprint 72570529B260E556349F3403F5CF5819D19B3B58 -Server Mailbox01 -FileName "\\FileServer01\Data\Fabrikam.req"

Пример 4

$txtcert = Export-ExchangeCertificate -Thumbprint 72570529B260E556349F3403F5CF5819D19B3B58 -Server Mailbox01

[System.IO.File]::WriteAllBytes('\\FileServer01\Data\Fabrikam.req', [System.Text.Encoding]::Unicode.GetBytes($txtcert))

Параметры

-BinaryEncoded

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр BinaryEncoded кодирует экспортируемый файл сертификата или запроса на сертификат по правилам DER. С этим параметром не нужно указывать значение.

Как правило, этот параметр используется при экспорте сертификата, так как позволяет хранить сертификат и его закрытый ключ или цепочку сертификатов в едином двоичном файле, если при этом также выбран параметр Password. Если этот параметр не используется, экспортированный файл сертификата имеет кодировку Base64, и необходимо отдельно экспортировать все промежуточные или корневые сертификаты в цепочке доверия.

Свойства параметров

Наборы параметров

-Confirm

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

• Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
• Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Свойства параметров

Наборы параметров

-DomainController

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Свойства параметров

Наборы параметров

-FileName

Применимо: Exchange Server 2013 г.

Примечание. Этот параметр был удален из Exchange 2016 и Exchange 2019 накопительным Обновления H1 2022, так как он принимает значения пути UNC. Чтобы экспортировать сертификат или запрос сертификата в файл без использования параметра FileName, используйте методы, описанные в примерах 2 и 4.

Этот параметр доступен только в Exchange 2013.

Параметр FileName определяет имя экспортируемого файла сертификата или запроса на сертификат и путь к нему. Вы можете использовать локальный путь, если сертификат или запрос сертификата находится на том же сервере Exchange Server, где выполняется команда. В противном случае используйте UNC-путь (\\Server\Share). Если значение содержит пробелы, его необходимо заключить в кавычки (").

Свойства параметров

Наборы параметров

-Identity

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр Identity определяет сертификат или запрос на сертификат, который нужно экспортировать. Допустимые значения:

• ServerNameOrFQDN\Thumbprint
• Thumbprint

Значение отпечатка можно найти с помощью командлета Get-ExchangeCertificate.

Этот параметр нельзя использовать вместе с параметром Server.

В качестве позиционного параметра для этого командлета выступает параметр Thumbprint, а не параметр Identity. Поэтому, когда указывается только значение отпечатка, команда использует это значение для параметра Thumbprint.

Свойства параметров

Наборы параметров

-Password

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр Password указывает пароль для закрытого ключа или цепочки сертификатов в файле экспортированного сертификата. Чтобы импортировать файл экспортированного сертификата на другом сервере, необходимо знать пароль.

В качестве значения для этого параметра можно использовать следующие методы:

• (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
• Перед выполнением этой команды сохраните пароль как переменную (например, $password = Read-Host "Enter password" -AsSecureString), а затем используйте переменную ($password) в качестве значения.
• (Get-Credential).password запрос на безопасный ввод пароля при выполнении этой команды.

Свойства параметров

Наборы параметров

-Server

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр Server задает сервер Exchange, на котором следует выполнить эту команду. Можно использовать любое значение, однозначно определяющее сервер. Примеры:

• Имя.
• полное доменное имя;
• различающееся имя (DN);
• Устаревшее различающееся имя Exchange

Устаревшее различающееся имя Exchange

Этот параметр нельзя использовать с параметром Identity, но можно использовать с параметром Thumbprint.

Свойства параметров

Наборы параметров

-Thumbprint

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр Thumbprint определяет сертификат или запрос на сертификат, который нужно экспортировать. Значение отпечатка можно найти с помощью командлета Get-ExchangeCertificate.

В качестве позиционного параметра для этого командлета выступает параметр Thumbprint, а не параметр Identity. Поэтому, когда указывается только значение отпечатка, команда использует это значение для параметра Thumbprint.

Свойства параметров

Наборы параметров

-WhatIf

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Свойства параметров

Наборы параметров

CommonParameters

Входные данные

Input types

Выходные данные

Output types