Set-SPTrustedRootAuthority
建立新的受信任根授權單位。
Syntax
Set-SPTrustedRootAuthority
[-Identity] <SPTrustedRootAuthorityPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Certificate <X509Certificate2>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Set-SPTrustedRootAuthority
[-Identity] <SPTrustedRootAuthorityPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-MetadataEndPoint <Uri>]
[-WhatIf]
[<CommonParameters>]
Description
Cmdlet Set-SPTrustedRootAuthority
會建立新的受根信任授權單位。
如果使用憑證檔案,憑證必須是沒有私密金鑰的 X509 憑證,否則會引發例外狀況。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet。
範例
------------------範例------------------
C:\PS>$cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2
$cert.Import('C:\LiveIDSigningCert.pfx')
Get-SPTrustedRootAuthority -Identity "WFEFarm1" | Set-SPTrustedRootAuthority -Certificate $cert
此範例會更新受信任根授權單位 WFEFarm1 的憑證。
參數
-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 |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Certificate
指定受信任根授權單位的 X.509 憑證。
此類型必須是有效的 X.509 憑證名稱,例如 Certificate1。
Type: | X509Certificate2 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
指定要更新的受信任根授權單位。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、受信任根授權單位的有效名稱 (例如 WFEFarm1),或有效之 SPTrustedRootAuthority 物件的執行個體。
Type: | SPTrustedRootAuthorityPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-MetadataEndPoint
{{Fill MetadataEndPoint Description}}
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 未執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |