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 网站所必需的。 但是,必须将从最终实体 (叶) 证书到根证书的整个证书链导入 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 场。

参数

-Confirm

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

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

-Exportable

指定是否可以导出导入 SharePoint 的证书的私钥。 如果未指定此参数,则部署到 SharePoint 场中每个服务器上的 Windows 证书存储的证书的私钥将不可导出,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

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

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

-工作分配

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