Set-SPMachineKey

配置 web 应用程序的 ASP.NET 视图状态解密和验证密钥。

语法

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

说明

`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 参数指定的新密钥。 新密钥仅部署到本地服务器。 场中的其他服务器将继续使用以前的密钥。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DecryptionKey

指定新的 ASP.NET 视图状态解密密钥。 该键应表示为 64 个字符的长十六进制字符串 (0-9 和 A-F) 。

如果未指定此参数,将生成并使用随机解密密钥。

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ValidationKey

指定新的 ASP.NET 视图状态验证密钥。 该键应表示为 64 个字符的长十六进制字符串 (0-9 和 A-F) 。

如果未指定此参数,将生成并使用随机解密密钥。

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

-WebApplication

指定 Web 应用程序的名称、URL 或 GUID。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。

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

-工作分配

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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