Set-SPMachineKey

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

設定 Web 應用程式的 ASP.NET 檢視狀態解密和驗證金鑰。

Syntax

Set-SPMachineKey
   -WebApplication <SPWebApplicationPipeBind>
   [-DecryptionKey <String>]
   [-ValidationKey <String>]
   [-Local]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

'Set-SPMachineKey' Cmdlet 會設定 Web 應用程式的 ASP.NET 檢視狀態解密和驗證金鑰。

範例

-------------範例 1-------------

Set-SPMachineKey -WebApplication http://sitename

本範例會將 Web 應用程式 ' http://sitename ' 的 ASP.NET 檢視狀態解密和驗證金鑰設定為新的隨機產生金鑰。新的金鑰會部署到伺服器陣列中的所有伺服器。

-------------範例 2-------------

Set-SPMachineKey -WebApplication http://sitename -DecryptionKey '509EEEE0709AE3EA2690017D174648075D3E7659FB7CBC65F08661F737610501' -ValidationKey '988EAEF669CC691E420C3887F54BDD7D0741C84CBA36406FCA5250B780771469' -Local

本範例會將 Web 應用程式 ' http://sitename ' 的 ASP.NET 檢視狀態解密和驗證金鑰設定為 DecryptionKey 和 ValidationKey 參數所指定的新金鑰。新的金鑰只會部署到本機伺服器。伺服器陣列中的其他伺服器會繼續使用先前的金鑰。

參數

-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 Subscription Edition

-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 Subscription Edition

-DecryptionKey

指定新的 ASP.NET 檢視狀態解密金鑰。索引鍵應該以 0-9 和 A-F) (64 個字元的長十六進位字串表示。

如果未指定此參數，則會產生並使用隨機解密金鑰。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Local

僅將新的解密和驗證金鑰部署到本機伺服器。伺服器陣列中的其他伺服器會繼續使用先前的解密和驗證金鑰。如果伺服器陣列中的每部伺服器上未同步處理這些金鑰，則在伺服器陣列中跨多部伺服器進行負載平衡的 Web 會話將會失敗。使用 Update-SPMachineKey Cmdlet 將金鑰部署至伺服器陣列中的其他伺服器。

如果未指定此參數，新的解密和驗證金鑰將會部署到伺服器陣列中的所有伺服器。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ValidationKey

指定新的 ASP.NET 檢視狀態驗證金鑰。索引鍵應該以 0-9 和 A-F) (64 個字元的長十六進位字串表示。