Share via


Update-SPSecureStoreMasterKey

 

適用版本: SharePoint Server 2010

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

會變更安全認證儲存服務應用程式的主要金鑰。

Syntax

Update-SPSecureStoreMasterKey -Passphrase <String> -ServiceApplicationProxy <SPServiceApplicationProxyPipeBind> [-AssignmentCollection <SPAssignmentCollection>]

詳細描述

Update-SPSecureStoreApplicationServerKey 指令程式會變更安全認證儲存服務應用程式的主要金鑰。

符合下列情況時,即需更新主要金鑰:

  • 已建立服務應用程式的新執行個體,且安全認證儲存服務應用程式的資料庫是新的且空的。

  • 主要金鑰或複雜密碼已遭洩露。

  • 安全性指導方針要求取代複雜密碼或金鑰。

Parameters

參數 必要 類型 描述

Passphrase

必要

System.String

指定用於安全認證儲存資料庫的複雜密碼。您輸入的複雜密碼不會儲存。請務必記下該複雜密碼並置於安全的地方。您需要有複雜密碼,才能新增新的安全認證儲存服務伺服器。

ServiceApplicationProxy

必要

Microsoft.SharePoint.PowerShell.SPServiceApplicationProxyPipeBind

指定包含要更新之主要金鑰的安全認證儲存服務應用程式的 Proxy。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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

注意

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

Reencrypt

選用

System.Management.Automation.SwitchParameter

指定要重新加密安全認證儲存服務應用程式的資料庫。這會在執行安全認證儲存應用程式之執行個體的所有伺服器中,同步處理主要金鑰。

輸入類型

傳回類型

Example

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

$newPassPhrase = "abcDEF123!"
Update-SPSecureStoreMasterKey -ServiceApplicationProxy $contosoProxy -Passphrase $newPassPhrase

此範例會針對指定的服務應用程式建立新的主要金鑰。

See Also

Reference

Update-SPSecureStoreApplicationServerKey