Update-SPSecureStoreApplicationServerKey

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

Synchronisiert den Schlüssel auf einem Microsoft SharePoint-Server mit dem Hauptschlüssel für einmaliges Anmelden.

Syntax

Update-SPSecureStoreApplicationServerKey
      -Passphrase <String>
      -ServiceApplicationProxy <SPServiceApplicationProxyPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [<CommonParameters>]

Beschreibung

Das Update-SPSecureStoreApplicationServerKey Cmdlet synchronisiert den Schlüssel auf einem SharePoint-Server mit dem Hauptschlüssel für die Secure Store-Dienstdatenbank.

Unter den folgenden ist die Aktualisierung eines Serverschlüssels erforderlich:

– Ein neuer SharePoint-Server, auf dem eine Secure Store-Dienstinstanz ausgeführt wird, wird mit der Farm verknüpft. – Der auf dem Server gespeicherte Schlüssel ist nicht der Schlüssel, der für die aktuelle Secure Store-Dienstdatenbank erforderlich ist (aufgrund von Server- oder Netzwerkproblemen). – Der Hauptschlüssel wird aktualisiert, aber während der Weitergabe des neuen Schlüssels schlägt dieser Prozess auf mindestens einem der Server fehl.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

--------------------BEISPIEL--------------------

$newPassPhrase = "abcDEF123!"
$proxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq 'Secure Store Service Application Proxy'}
Update-SPSecureStoreApplicationServerKey -ServiceApplicationProxy $proxy -Passphrase $newPassPhrase

Dieses Beispiel synchronisiert die Passphrase des Serverschlüssels für einen SharePoint-Server mit dem Hauptschlüssel für die Dienstdatenbank für einmaliges Anmelden.

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

-Passphrase

Gibt die Passphrase an, die für die Dienstdatenbank für einmaliges Anmelden verwendet wird.

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

-ServiceApplicationProxy

Gibt den Proxy der Dienstanwendung an, die den zu synchronisierenden Serverschlüssel enthält.

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