Export-SPCertificate

参考

模块:: sharepoint-server

从 SharePoint 场导出证书。

语法

Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Password <SecureString>
      [-EncryptionType <String>]
      [-IncludeAllCertificatesInCertificationPath]
      [-NoExtendedProperties]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Type <String>
      [-IncludeAllCertificatesInCertificationPath]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

将证书从 SharePoint 场导出到证书文件中。默认情况下，此导出的证书文件存储在管理中心站点中，但也可以存储在 Path 参数指定的路径中。

SharePoint 支持将证书导出到 PFX (PKCS #12) 文件、P7B (PKCS #7) 文件和 CER 文件。 PFX 文件和 P7B 文件都可以包含多个证书，这对于将证书链从最终实体 (叶) 证书导出到根证书非常有用。但是，只有 PFX 文件才能包含证书的私钥，这是将服务器证书分配给 IIS 网站所必需的。 CER 文件仅包含一个证书。

示例

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

$password = ConvertTo-SecureString -AsPlainText -Force 
 
Export-SPCertificate -Identity "Team Sites Certificate" -Password $password -IncludeAllCertificatesInCertificationPath -Path "\\server\fileshare\certificates.pfx"

本示例将“团队网站证书”证书及其私钥及其证书链中的其他证书导出到 \\server\fileshare\certificates.pfx 文件。

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

Export-SPCertificate -Identity "Team Sites Certificate" -Type Cert

本示例将“团队网站证书”证书导出到存储在管理中心中的 Cert 文件。

参数

-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

-EncryptionType

指定用于保护导出的 PFX 文件的加密算法。 AES256 指定将使用具有 SHA256 哈希的 AES-256 加密。 TripleDes 指定将使用具有 SHA1 哈希的 3DES 加密。 AES-256 加密比 3DES 加密更强，但仅受 Windows Server 2019 和更新操作系统上的 PFX 文件支持。如果 PFX 文件需要与旧操作系统兼容，请使用 3DES 加密。如果未指定此参数，则默认使用 AES-256 加密。此参数仅与 PFX 文件兼容。

Type:	String
Accepted values:	AES256, TripleDes
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

指定覆盖文件（如果文件已存在于指定路径）。

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

-Identity

要导出的证书。

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

-IncludeAllCertificatesInCertificationPath

指定是否导出属于指定证书证书链的一部分的其他证书。这只会添加指定证书的父证书，而不添加指定证书颁发的子证书。此参数仅与 PFX 和 P7B 文件兼容。

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

-NoExtendedProperties

指定是否不应导出证书的扩展属性，例如证书的友好名称。此参数仅与 PFX 文件兼容。

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

-Password

用于保护导出的 PFX 文件的密码。此参数仅与 PFX 文件兼容。

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

-Path

证书应导出到的 PFX、P7B 或 CER 文件的路径。

无论是否指定此参数，证书也将导出到管理中心中存储的证书文件。

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

-Type

指定要生成的文件类型。证书将生成包含单个 DER 编码证书的 CER 文件。 Pkcs7 将生成包含一个或多个证书的 P7B (PKCS #7) 文件。此参数仅与 CER 和 P7B 文件兼容。

Type:	String
Accepted values:	Cert, Pkcs7
Position:	Named
Default value:	None
Required:	True
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

通过