New-SPTrustedRootAuthority

發行項
03/07/2017

適用版本： SharePoint Foundation 2013, SharePoint Server 2013

上次修改主題的時間： 2015-03-09

建立信任的根授權單位。

Syntax

New-SPTrustedRootAuthority [-Name] <String> -Certificate <X509Certificate2> [-AssignmentCollection <SPAssignmentCollection>]

詳細描述

New-SPTrustedRootAuthority Cmdlet 會建立信任的根授權單位。如果使用憑證檔案，則其必須只有一個 X509 憑證，沒有私密金鑰，否則會引起例外狀況。

Parameters

參數	必要	類型	描述
Name	必要	System.String	指定要建立之信任根授權單位的名稱。此類型必須是有效的信任根授權單位名稱；例如，WFEFarm1。
Certificate	必要	System.Security.Cryptography.X509Certificates.X509Certificate2	指定信任根授權單位的 X.509 憑證。此類型必須是有效的 X.509 憑證名稱，例如 Certificate1。
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。

Name

必要

System.String

指定要建立之信任根授權單位的名稱。

此類型必須是有效的信任根授權單位名稱；例如，WFEFarm1。

Certificate

必要

System.Security.Cryptography.X509Certificates.X509Certificate2

指定信任根授權單位的 X.509 憑證。

此類型必須是有效的 X.509 憑證名稱，例如 Certificate1。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。

注意

使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。

輸入類型

傳回類型

Example

------------------範例------------------

$cert = Get-PfxCertificate C:\LiveIDSigningCert.pfx
New-SPTrustedRootAuthority -Name "WFEFarm1" -Certificate $cert

此範例會建立新的信任根授權單位 WFEFarm1。