Import-SPCertificate

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

将证书导入 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 网站所必需的。但是，整个证书链（从最终实体 (叶) 证书到根证书）必须导入 SharePoint，SSL 连接才能成功。

证书导入 SharePoint 时，会自动部署到 SharePoint 场中每个服务器上的 Windows 证书存储。当这些服务器加入场时，证书也会自动部署到 SharePoint 场中的新服务器。

断开服务器与 SharePoint 场的连接不会自动从该服务器的 Windows 证书存储中删除 SharePoint 托管的证书。从服务器卸载 SharePoint 不会自动从该服务器的 Windows 证书存储中删除 SharePoint 托管证书。

示例

------------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

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Exportable

指定是否可以导出导入 SharePoint 中的证书的私钥。如果未指定此参数，则部署到 SharePoint 场中每个服务器上的 Windows 证书存储的证书的私钥将不可导出，并且 SharePoint 将不允许从 SharePoint 管理界面中导出私钥。

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

-Password

如果证书文件受 PFX 文件) 的密码 (保护，则为密码。

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

-Path

包含证书的 PFX、P7B 或 CER 文件的路径。

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

-Replace

指定如果导入的证书正在续订现有证书，则应立即将现有证书的证书分配替换为导入的证书。

如果导入的证书未续订现有证书，则不会对证书分配进行更改。

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

-Store

证书应导入到的证书存储区。除非需要重写 SharePoint 的自动证书检测，否则我们建议省略此参数，以便 SharePoint 自动为每个证书选择适当的证书存储。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。此 cmdlet 未运行。

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