Freigeben über


Set-SPProjectQueueSettings

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

Syntax

Default (Standardwert)

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

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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.

Parametereigenschaften

Typ:SPAssignmentCollection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CleanupNonSuccessAgeLimit

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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)

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CleanupSuccessAgeLimit

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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)

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MaxConnections

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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

Standard: 10

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MaxDegreeOfConcurrency

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MsgRetryInterval

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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)

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MsgRetryLimit

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NetTcpPort

Anwendbar: Project Server 2016, Project Server 2019

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PeriodicTasksInterval

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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)

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-QueueTimeout

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServiceApplication

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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 instance eines gültigen PsiServiceApplication-Objekts.

Parametereigenschaften

Typ:PsiServiceApplicationPipeBind
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:sa

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SqlCommandTimeout

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

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)

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SqlRetryInterval

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

Wenn die Warteschlange aufgrund eines vorübergehenden SQL-Problems (z. B. eines SQL-Deadlocks) 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)

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SqlRetryLimit

Anwendbar: Project Server 2013, Project Server 2016, Project Server 2019

Wenn die Warteschlange aufgrund eines vorübergehenden SQL-Problems (z. B. eines SQL-Deadlocks) 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.

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.