Import-SPCertificate

Импортирует сертификаты в ферму SharePoint.

Синтаксис

Import-SPCertificate
      [-Path] <String>
      [-Password <SecureString>]
      [-Store <String>]
      [-Exportable]
      [-Replace]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Импортирует сертификаты из указанного файла в ферму SharePoint.

SharePoint поддерживает сертификаты шифрования RSA и эллиптических кривых (ECC). Вы можете импортировать сертификаты из файлов PFX (PKCS #12), P7B (PKCS 7) и CER-файлов. Только PFX-файлы будут содержать закрытые ключи для сертификатов, которые необходимы для назначения сертификата сервера веб-сайту IIS. Однако для успешного выполнения SSL-подключений в SharePoint необходимо импортировать всю цепочку сертификатов , от конечного сертификата сущности (конечного сертификата) до корневого сертификата.

Сертификаты автоматически развертываются в хранилище сертификатов Windows на каждом сервере фермы SharePoint при импорте в SharePoint. Сертификаты также автоматически развертываются на новых серверах в ферме SharePoint при присоединении этих серверов к ферме.

Отключение сервера от фермы SharePoint не приведет к автоматическому удалению управляемых SharePoint сертификатов из хранилища сертификатов Windows этого сервера. Удаление SharePoint с сервера не приведет к автоматическому удалению управляемых SharePoint сертификатов из хранилища сертификатов Windows этого сервера.

Примеры

------------EXAMPLE 1-----------

$password = ConvertTo-SecureString -AsPlainText -Force 
 
Import-SPCertificate -Path "\\server\fileshare\certificates.pfx" -Password $password -Exportable

В этом примере \\сертификаты и все связанные закрытые ключи импортируются из файла server\fileshare\certificates.pfx в ферму SharePoint. Он также позволяет экспортировать закрытые ключи, импортированные во время этой операции, из SharePoint в будущем.

------------EXAMPLE 2-----------

Import-SPCertificate -Path D:\test.cer

В этом примере сертификат импортируется из файла D:\test.cer в ферму SharePoint.

Параметры

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Перед запуском командлет запросит подтверждение.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Exportable

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Password

Пароль, если файл сертификата защищен паролем (для PFX-файлов).

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

Путь к PFX-файлу, P7B или CER-файлу, содержащему сертификаты.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Replace

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

Если импортируемые сертификаты не обновляют существующие сертификаты, изменения в назначении сертификатов не вносятся.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Store

Хранилище сертификатов, в которое необходимо импортировать сертификаты. Если нет необходимости переопределять автоматическое обнаружение сертификатов SharePoint, рекомендуется опустить этот параметр, чтобы SharePoint автоматически выберет соответствующее хранилище сертификатов для каждого сертификата.

Type:String
Accepted values:EndEntity, Intermediate, Pending, Root
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет при этом не запускается.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False