Set-SPMachineKey

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

Konfiguriert die ASP.NET Ansichtszustandsentschlüsselung und Validierungsschlüssel einer Webanwendung.

Syntax

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

Beschreibung

Das Cmdlet "Set-SPMachineKey" konfiguriert die ASP.NET Ansichtszustandsentschlüsselung und Validierungsschlüssel einer Webanwendung.

Beispiele

-------------BEISPIEL 1-------------

Set-SPMachineKey -WebApplication http://sitename

In diesem Beispiel wird die ASP.NET Ansichtszustandsentschlüsselung und Validierungsschlüssel für die Webanwendung "http://sitename" auf neue zufällig generierte Schlüssel festgelegt. Die neuen Schlüssel werden auf allen Servern in der Farm bereitgestellt.

-------------BEISPIEL 2-------------

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

In diesem Beispiel werden die ASP.NET Ansichtszustandsentschlüsselung und Validierungsschlüssel für die Webanwendung "http://sitename" auf neue Schlüssel festgelegt, die von den DecryptionKey- und ValidationKey-Parametern angegeben werden. Die neuen Schlüssel werden nur auf dem lokalen Server bereitgestellt. Andere Server in der Farm verwenden weiterhin die vorherigen Schlüssel.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

Gibt den neuen ASP.NET Ansichtsstatus-Entschlüsselungsschlüssel an. Der Schlüssel sollte als 64 Zeichen lange hexadezimale Zeichenfolge (0-9 und A-F) dargestellt werden.

Wenn dieser Parameter nicht angegeben ist, wird ein zufälliger Entschlüsselungsschlüssel generiert und verwendet.

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

-Local

Stellen Sie die neuen Entschlüsselungs- und Validierungsschlüssel nur auf dem lokalen Server bereit. Andere Server in der Farm verwenden weiterhin die vorherigen Entschlüsselungs- und Validierungsschlüssel. Websitzungen, bei denen ein Lastenausgleich über mehrere Server in der Farm erfolgt, schlagen fehl, wenn diese Schlüssel nicht auf jedem Server in der Farm synchronisiert werden. Verwenden Sie das Cmdlet Update-SPMachineKey, um die Schlüssel auf zusätzlichen Servern in der Farm bereitzustellen.

Wenn dieser Parameter nicht angegeben wird, werden die neuen Entschlüsselungs- und Validierungsschlüssel auf allen Servern in der Farm bereitgestellt.

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

-ValidationKey

Gibt den neuen ASP.NET Überprüfungsschlüssel für den Ansichtszustand an. Der Schlüssel sollte als 64 Zeichen lange hexadezimale Zeichenfolge (0-9 und A-F) dargestellt werden.