Update-SPProfileSync

  • Referenz
Modul:
SharePointServer

Aktualisierungen die Konfiguration des Auftrags "Benutzerprofilsynchronisierung" basierend auf den angegebenen Parametern.

Syntax

Update-SPProfileSync
      [[-ExcludeWebApplications] <String>]
      [[-SynchronizationTiming] <String>]
      [[-SweepTiming] <String>]
      [[-IgnoreIsActive] <Boolean>]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-SPProfileSync aktualisiert die Konfiguration des Auftrags "Benutzerprofilsynchronisierung" basierend auf den angegebenen Parametern.

Beispiele

BEISPIEL 1

Update-SPProfileSync -IgnoreIsActive:$false

In diesem Beispiel wird der Auftrag "Benutzerprofilsynchronisierung" so aktualisiert, dass er so markiert wird, dass alle Benutzer unabhängig von ihrer Aktivität synchronisiert werden, ohne zur Bestätigung des Benutzers aufzufordern.

BEISPIEL 2

Update-SPProfileSync -SynchronizationTiming "every 15 minutes"

In diesem Beispiel wird der Auftrag "Benutzerprofilsynchronisierung" so aktualisiert, dass er alle 15 Minuten ausgeführt wird, ohne zur Bestätigung durch den Benutzer aufzufordern.

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

-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

-ExcludeWebApplications

Durch Trennzeichen getrennte Liste von Webanwendungs-URLs, die bei der Synchronisierung von der Berücksichtigung ausgeschlossen werden sollen.

Mit den angegebenen Werten werden alle vorhandenen Werte gelöscht.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IgnoreIsActive

Gibt an, ob nur aktive Profile oder alle Profile synchronisiert werden sollen. Benutzerprofile von Benutzern, die zur Website beitragen, werden als aktiv betrachtet.

Die gültigen Werte sind True oder False.

Type:Boolean
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SweepTiming

Führt dieselben Aufgaben wie der SynchronizationTiming-Parameter aus. Der SweepTiming-Parameter legt jedoch den Zeitplan für den "Sweep"-Auftrag fest. Der Sweep-Auftrag wird vom SharePoint Foundation-Änderungsprotokoll gesteuert und als einfache Möglichkeit zum Erfassen neuer hinzugefügter Benutzer verwendet. Beispielsweise wird einer vollständig synchronisierten Website anschließend ein Benutzer hinzugefügt. Der Sweep-Auftrag stellt sicher, dass der inkrementelle neu hinzugefügte Benutzer die Eigenschaften des Benutzerprofils schnell repliziert erhält.

Der Standardwert ist jede Minute.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SynchronizationTiming

Legt den Zeitplan für den Hauptsynchronisierungsauftrag fest. Sie können den Zeitplan mit einer Textzeichenfolge im SPSchedule-Format erwähnen (z. B. "alle 15 Minuten" bedeutet, dass der Auftrag alle 15 Minuten ausgeführt werden soll. "täglich um 09:00:00 Uhr" bedeutet, dass der Auftrag täglich um 9:00 Uhr ausgeführt werden soll).

Der Standardwert ist einmal pro Stunde.

Sie können die Zeichenfolgenmethode SPSchedule.FromString() verwenden, um die Zeichenfolgen "alle 5 Minuten" oder "wöchentlich xxxxxxx" zu übergeben.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False