Export-SPCertificate

參考

模組:: sharepoint-server

從 SharePoint 伺服器陣列匯出憑證。

Syntax

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

Description

將憑證從 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

指定要產生的檔案類型。 Cert 會產生包含單一 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