Import-SPCertificate

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

將憑證匯入 SharePoint 伺服器陣列。

Syntax

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

Description

將憑證從指定的檔案匯入 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