Set-SPMachineKey

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

Configura as chaves de descriptografia e validação do estado de exibição ASP.NET de um aplicativo Web.

Syntax

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

Description

O cmdlet 'Set-SPMachineKey' configura o ASP.NET exibir chaves de descriptografia e validação do estado de um aplicativo Web.

Exemplos

---------------EXEMPLO 1--------------

Set-SPMachineKey -WebApplication http://sitename

Este exemplo define o ASP.NET exibir chaves de descriptografia e validação de estado para o aplicativo Web 'http://sitename' como novas chaves geradas aleatoriamente. As novas chaves são implantadas em todos os servidores do farm.

---------------EXEMPLO 2--------------

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

Este exemplo define o ASP.NET exibir chaves de descriptografia e validação de estado para o aplicativo Web 'http://sitename' para novas chaves especificadas pelos parâmetros DecryptionKey e ValidationKey. As novas chaves são implantadas apenas no servidor local. Outros servidores no farm continuarão a usar as chaves anteriores.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

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

-Confirm

Solicita a confirmação antes de executar o 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

Especifica a nova chave de descriptografia do estado de exibição do ASP.NET. A chave deve ser representada como uma cadeia de caracteres hexadecimal de 64 caracteres (0-9 e A-F).

Se esse parâmetro não for especificado, uma chave de descriptografia aleatória será gerada e usada.

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

-Local

Implante as novas chaves de descriptografia e validação apenas no servidor local. Outros servidores no farm continuarão a usar as chaves de descriptografia e validação anteriores. As sessões da Web que são balanceadas por carga entre vários servidores no farm falharão se essas chaves não forem sincronizadas em todos os servidores do farm. Use o cmdlet Update-SPMachineKey para implantar as chaves em servidores adicionais no farm.

Se esse parâmetro não for especificado, as novas chaves de descriptografia e validação serão implantadas em todos os servidores do farm.

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

-ValidationKey

Especifica a nova chave de validação de estado de exibição de ASP.NET. A chave deve ser representada como uma cadeia de caracteres hexadecimal de 64 caracteres (0-9 e A-F).