Set-SPMachineKey

  • Référence
Module:
sharepoint-server
S’applique à:
SharePoint Server Subscription Edition

Configure la ASP.NET clés de déchiffrement et de validation de l’état d’affichage d’une application web.

Syntax

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

Description

L’applet de commande « Set-SPMachineKey » configure la ASP.NET clés de déchiffrement et de validation de l’état d’affichage d’une application web.

Exemples

-------------EXEMPLE 1-------------

Set-SPMachineKey -WebApplication http://sitename

Cet exemple montre comment définir le ASP.NET clés de déchiffrement et de validation de l’état d’affichage pour l’application web «http://sitename » sur de nouvelles clés générées de manière aléatoire. Les nouvelles clés sont déployées sur tous les serveurs de la batterie de serveurs.

-------------EXEMPLE 2-------------

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

Cet exemple montre comment définir le ASP.NET clés de déchiffrement et de validation de l’état d’affichage pour l’application web «http://sitename » sur les nouvelles clés spécifiées par les paramètres DecryptionKey et ValidationKey. Les nouvelles clés sont déployées uniquement sur le serveur local. Les autres serveurs de la batterie continueront d’utiliser les clés précédentes.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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

-Confirm

Une invite de confirmation apparaît avant d’exécuter le 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

Spécifie la nouvelle clé de déchiffrement de l’état d’affichage ASP.NET. La clé doit être représentée sous la forme d’une chaîne hexadécimale longue de 64 caractères (0-9 et A-F).

Si ce paramètre n’est pas spécifié, une clé de déchiffrement aléatoire est générée et utilisée.

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

-Local

Déployez les nouvelles clés de déchiffrement et de validation uniquement sur le serveur local. Les autres serveurs de la batterie continueront d’utiliser les clés de déchiffrement et de validation précédentes. Les sessions web dont la charge est équilibrée sur plusieurs serveurs de la batterie échouent si ces clés ne sont pas synchronisées sur chaque serveur de la batterie. Utilisez l’applet de commande Update-SPMachineKey pour déployer les clés sur d’autres serveurs de la batterie de serveurs.

Si ce paramètre n’est pas spécifié, les nouvelles clés de déchiffrement et de validation sont déployées sur tous les serveurs de la batterie.

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

-ValidationKey

Spécifie la nouvelle clé de validation de l’état d’affichage ASP.NET. La clé doit être représentée sous la forme d’une chaîne hexadécimale longue de 64 caractères (0-9 et A-F).

Si ce paramètre n’est pas spécifié, une clé de déchiffrement aléatoire est générée et utilisée.

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

-WebApplication

Spécifie le nom, l'URL ou le GUID de l'application 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

Présente ce qui se produit si le cmdlet s’exécute. Le cmdlet n’est pas exécutée.

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