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 |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。 注意 使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。 |
Reencrypt |
選用 |
System.Management.Automation.SwitchParameter |
指定要重新加密安全認證儲存服務應用程式的資料庫。這會在執行安全認證儲存應用程式之執行個體的所有伺服器中,同步處理主要金鑰。 |
輸入類型
傳回類型
Example
------------------範例------------------
$newPassPhrase = "abcDEF123!"
Update-SPSecureStoreMasterKey -ServiceApplicationProxy $contosoProxy -Passphrase $newPassPhrase
此範例會針對指定的服務應用程式建立新的主要金鑰。