Set-SPProjectQueueSettings

Referenz

Modul:: SharePointServer

Gilt für::: Project Server 2013, Project Server 2016, Project Server 2019

Legt den Wert einer oder mehrerer Project Server-Warteschlangeneinstellungen für eine bestimmte Project Server-Dienstanwendung fest.

Syntax

Set-SPProjectQueueSettings
   [-ServiceApplication <PsiServiceApplicationPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CleanupNonSuccessAgeLimit <Int32>]
   [-CleanupSuccessAgeLimit <Int32>]
   [-MaxConnections <Int32>]
   [-MaxDegreeOfConcurrency <Int32>]
   [-MsgRetryInterval <Int32>]
   [-MsgRetryLimit <Int32>]
   [-PeriodicTasksInterval <Int32>]
   [-QueueTimeout <Int32>]
   [-SqlCommandTimeout <Int32>]
   [-SqlRetryInterval <Int32>]
   [-SqlRetryLimit <Int32>]
   [-NetTcpPort <Int32>]
   [<CommonParameters>]

Beschreibung

Legt den Wert einer oder mehrerer Project Server-Warteschlangeneinstellungen für eine bestimmte Project Server-Dienstanwendung fest.

Berechtigungen und aktuelle Informationen zu Windows PowerShell für Project Server finden Sie in der Onlinedokumentation unter https://go.microsoft.com/fwlink/p/?LinkId=251833 (https://go.microsoft.com/fwlink/p/?LinkId=251833).

Beispiele

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

Set-SPProjectQueueSettings -ServiceApplication "Project Service Application" -MaxDegreeOfConcurrency 6

In diesem Beispiel wird 6 als maximale Anzahl von Aufträgen festgelegt, die gleichzeitig von der angegebenen Dienstanwendung ausgeführt werden können.

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:	Project Server 2013, Project Server 2016, Project Server 2019

-CleanupNonSuccessAgeLimit

Mit dieser Einstellung wird die Altersschwelle bestimmt, bei der ein Auftrag mit einem abgeschlossenen, nicht erfolgreichen Status (z. B. Fehlerhafte, jedoch nicht sperrende Korrelation) gelöscht werden kann, wenn der Auftrag Warteschlangencleanup ausgeführt wird. Das Alter eines Auftrags wird durch das Datum und die Uhrzeit seines Abschlusses bestimmt. Falls ein Auftrag beispielsweise am 01.02.2007 um 22:41 Uhr abgebrochen wurde und der Auftrag "Warteschlangencleanup" am 02.02.2007 um 23:55 Uhr ausgeführt wird, wird der Auftrag nicht gelöscht (vorausgesetzt, die Altersschwelle für das Cleanup von nicht erfolgreich abgeschlossenen Aufträgen beträgt 7 Tage). Da die Anzahl von abgeschlossenen, nicht erfolgreichen Aufträgen in der Regel niedrig ist, wird die Einstellung "Altersschwelle für das Cleanup von nicht erfolgreich abgeschlossenen Aufträgen" häufig auf den hohen Wert "168" (7 Tage) festgelegt.

Minimum: 1;Maximum: 100000;Standard: 168 (7 Tage)

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-CleanupSuccessAgeLimit

Mit dieser Einstellung wird die Altersschwelle bestimmt, bei der erfolgreiche Aufträge gelöscht werden können, wenn der Auftrag Warteschlangencleanup ausgeführt wird. Das Alter eines Auftrags wird durch das Datum und die Uhrzeit seines Abschlusses bestimmt. Falls ein Auftrag beispielsweise am 01.02.2007 um 22:41 Uhr abgeschlossen wurde und der Auftrag "Warteschlangencleanup" am 02.02.2007 um 23:55 Uhr ausgeführt wird, wird der Auftrag gelöscht (vorausgesetzt, die Altersschwelle für das Cleanup von erfolgreichen Aufträgen beträgt 1 Tag). Da die Anzahl von erfolgreichen Aufträgen in der Regel hoch ist, wird die Einstellung "Altersschwelle für das Cleanup von erfolgreichen Aufträgen" häufig auf den niedrigen Wert "24" (1 Tag) festgelegt.

Minimum: 1;Maximum: 100000;Standard: 24 (1 Tag)

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-MaxConnections

Maximal zulässige Anzahl von Warteschlangenverbindungen auf dem Server, deren Ausgabe aussteht.

Standard: 10

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-MaxDegreeOfConcurrency

Die Warteschlange besteht aus mehreren Threads, wodurch das gleichzeitige Verarbeiten mehrerer Aufträge ermöglicht wird. Diese Einstellung schränkt den Grad der Parallelität der Warteschlange ein. Beachten Sie, dass diese Einstellung pro Project Server-Dienstanwendung gilt.

Minimum: 1;Maximum: 10;Standard: 4

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-MsgRetryInterval

Falls bei der Auftragsverarbeitung aufgrund vorübergehender Probleme (wie einem SQL Deadlock) Fehler auftreten, wartet die Warteschlange, bis das Wiederholungsintervall abgelaufen ist, und wiederholt den Auftrag, anstatt für den Auftrag einen Fehler auszugeben.

Minimum: 0 (sofortige Wiederholung);Maximum: 300.000 (5 Minuten);Standard: 1000 (1 Sekunde)

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-MsgRetryLimit

Falls bei der Auftragsverarbeitung aufgrund vorübergehender Probleme (wie einem SQL-Deadlock) Fehler auftreten, wiederholt die Warteschlange den Auftrag, anstatt für den Auftrag einen Fehler auszugeben. Die Anzahl von Wiederholungen ist an das Wiederholungslimit gebunden.

Minimum: 0 (keine Wiederholung);Maximum: 100;Standard: 5

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-NetTcpPort

Legt den TCP-Port fest, den der Project Queue-Dienst verwendet.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2016, Project Server 2019

-PeriodicTasksInterval

Es gibt eine Reihe von Buchhaltungsaufgaben, die vom Warteschlangensystem ausgeführt werden. Einige Beispiele sind Aktivierungsaufträge im Zustand "Ruhezustand", Aktualisieren des Taktzeitstempels, Überprüfen, ob die Warteschlangenbereinigung ausgeführt werden muss usw. Mit dieser Einstellung wird das Zeitintervall gesteuert, in dem diese Ausgaben ausgeführt werden.

Minimum: 500 (1/2 Sekunde);Maximum: 300.000 (5 Minuten);Standard: 10.000 (10 Sekunden)

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-QueueTimeout

Das Warteschlangensystem verfügt über ein Feature zur Wiederherstellung nach einem Failover. Wenn die Farm mehrere Server enthält, auf denen der Project Server-Anwendungsdienst ausgeführt wird und der Warteschlangendienst auf einem Server ausfällt, werden Aufträge automatisch auf andere Server verteilt, auf denen der Warteschlangendienst online ist. Es wird ein Timeoutfehler für einen Warteschlangendienst ausgegeben, wenn für eine längere Zeit als im Warteschlangentimeout-Intervall angegeben nicht vom Zeitgeberauftrag für die Warteschlangenintegrität darauf zugegriffen werden kann.

Minimum: 5 Minuten;Maximum: 60 Minuten;Standard: 15 Minuten

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-ServiceApplication

Gibt die Project Server-Dienstanwendung an, die als Ziel verwendet werden soll.

Der Typ muss eine gültige GUID im Format 12345678-90ab-cdef-1234-567890bcdefgh sein; einen gültigen Namen einer Project Server-Dienstanwendung (z. B. ProjectServiceApp1); oder eine Instanz eines gültigen PsiServiceApplication-Objekts.

Type:	PsiServiceApplicationPipeBind
Aliases:	sa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-SqlCommandTimeout

Die Warteschlange nimmt SQL-Aufrufe zum Abrufen und Ausführen von Aufträgen vor. Diese Einstellung steuert den Timeoutwert aller solcher Aufrufe. Wenn bei einem Auftrag Fehler aufgrund eines SQL-Timeouts auftreten, können Administratoren diese Einstellung erhöhen und den Auftrag wiederholen.

Minimum: 30 Sekunden;Maximum: 86.400 (1 Tag);Standard: 1800 (30 Minuten)

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-SqlRetryInterval

Wenn die Warteschlange aufgrund eines vorübergehenden SQL-Problems (z. B. einem SQL-Deadlock) keine Verbindung mit einer Project Web App-Datenbank herstellen kann, wartet die Warteschlange, bis das SQL-Wiederholungsintervall abgelaufen ist, und versucht die Abfrage erneut.

Minimum: 0 (sofortige Wiederholung);Maximum: 60.000 (1 Minute);Standard: 1000 (1 Sekunde)

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-SqlRetryLimit

Wenn die Warteschlange aufgrund eines vorübergehenden SQL-Problems (z. B. einem SQL-Deadlock) keine Verbindung mit einer Project Web App-Datenbank herstellen kann, versucht die Warteschlange die Abfrage nach Ablauf des SQL-Wiederholungsintervalls erneut. Die Anzahl von Wiederholungen ist an das SQL-Wiederholungslimit gebunden.