Set-SPMachineKey

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

Configura la ASP.NET visualizzare le chiavi di decrittografia e convalida dello stato di un'applicazione Web.

Sintassi

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

Descrizione

Il cmdlet 'Set-SPMachineKey' configura le chiavi di decrittografia e convalida dello stato di visualizzazione ASP.NET di un'applicazione Web.

Esempio

-------------ESEMPIO 1-------------

Set-SPMachineKey -WebApplication http://sitename

In questo esempio vengono impostate le chiavi di decrittografia e convalida dello stato di visualizzazione ASP.NET per l'applicazione Web 'http://sitename' su nuove chiavi generate in modo casuale. Le nuove chiavi vengono distribuite in tutti i server della farm.

-------------ESEMPIO 2-------------

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

In questo esempio vengono impostate le chiavi di decrittografia e convalida dello stato di visualizzazione ASP.NET per l'applicazione Web 'http://sitename' sulle nuove chiavi specificate dai parametri DecryptionKey e ValidationKey. Le nuove chiavi vengono distribuite solo nel server locale. Gli altri server nella farm continueranno a usare le chiavi precedenti.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

-Confirm

Richiede la conferma prima di eseguire il 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

Specifica la nuova chiave di decrittografia dello stato di visualizzazione ASP.NET. La chiave deve essere rappresentata come stringa esadecimale lunga 64 caratteri (0-9 e A-F).

Se questo parametro non è specificato, verrà generata e usata una chiave di decrittografia casuale.

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

-Local

Distribuire le nuove chiavi di decrittografia e convalida solo nel server locale. Altri server nella farm continueranno a usare le chiavi di decrittografia e convalida precedenti. Le sessioni Web con carico bilanciato tra più server della farm avranno esito negativo se queste chiavi non sono sincronizzate in ogni server della farm. Usare il cmdlet Update-SPMachineKey per distribuire le chiavi in server aggiuntivi nella farm.

Se questo parametro non viene specificato, le nuove chiavi di decrittografia e convalida verranno distribuite in tutti i server della 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

Specifica la nuova chiave di convalida dello stato di visualizzazione ASP.NET. La chiave deve essere rappresentata come stringa esadecimale lunga 64 caratteri (0-9 e A-F).

Se questo parametro non è specificato, verrà generata e usata una chiave di decrittografia casuale.

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

-WebApplication

Specifica il nome, l'URL o il GUID dell'applicazione Web.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Share via