Set-SPProjectQueueSettings
Définit la valeur d’un ou plusieurs paramètres de file d’attente Project Server pour une application de service Project Server spécifique.
Syntaxe
Default (Par défaut)
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>]
Description
Définit la valeur d’un ou plusieurs paramètres de file d’attente Project Server pour une application de service Project Server spécifique.
Pour obtenir les autorisations et les informations les plus actuelles sur Windows PowerShell pour Project Server, consultez la documentation en ligne à l’adresse https://go.microsoft.com/fwlink/p/?LinkId=251833 (https://go.microsoft.com/fwlink/p/?LinkId=251833).
Exemples
EXEMPLE
Set-SPProjectQueueSettings -ServiceApplication "Project Service Application" -MaxDegreeOfConcurrency 6
Cet exemple définit à 6 le nombre maximal de travaux pouvant être traités en une seule fois par l’application de service spécifiée.
Paramètres
-AssignmentCollection
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.
Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global.
Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.
Propriétés du paramètre
| Type: | SPAssignmentCollection |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CleanupNonSuccessAgeLimit
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Ce paramètre détermine le seuil relatif à l’âge auquel un travail non terminé (exemple : Corrélation échouée mais non bloquante) peut être purgé lors du Nettoyage de la file d’attente. L’âge de chaque travail est déterminé par la date et l’heure de fin. Par exemple, si un travail a été annulé le 1/2/2007 à 22:41 et que le Nettoyage de la file d’attente s’exécute le 2/2/2007 à 23:55, le travail ne sera pas purgé (en supposant que l’âge limite pour le nettoyage des travaux non terminés est de 7 jours). Le nombre de travaux non terminés n’étant généralement pas élevé, la valeur affectée à l’option Âge limite pour le nettoyage des travaux non terminés est souvent définie à une valeur élevée : 168 (7 jours).
Minimum : 1 ; maximum : 100 000 ; par défaut : 168 (7 jours)
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CleanupSuccessAgeLimit
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Ce paramètre détermine le seuil relatif à l’âge auquel les travaux terminés peuvent être purgés lors du Nettoyage de la file d’attente. L’âge de chacun des travaux est déterminé par la date et l’heure de fin. Par exemple, si un travail s’est terminé le 1/2/2007 à 22:41 et que le Nettoyage de la file d’attente s’exécute le 2/2/2007 à 23:55, le travail sera purgé (en supposant que l’âge limite pour le nettoyage des travaux terminés est de 1 jour). Le nombre de travaux terminés étant généralement élevé, la valeur affectée à l’option Âge limite pour le nettoyage des travaux terminés est souvent définie à une valeur faible : 24 (1 jour).
Minimum : 1 ; maximum : 100 000 ; par défaut : 24 (1 jour)
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MaxConnections
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Nombre maximal de connexions à la file d’attente qui peuvent être en attente de distribution sur le serveur.
Par défaut : 10
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MaxDegreeOfConcurrency
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
La file d’attente est multi-thread et permet de traiter plusieurs travaux simultanément. Ce paramètre permet de limiter le degré de simultanéité de la file d’attente. Notez que ce paramètre est défini par application de service Project Server.
Minimum : 1 ; maximum : 10 ; par défaut : 4
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MsgRetryInterval
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Si le traitement d’un travail échoue en raison de problèmes temporaires (par exemple un blocage SQL), au lieu de faire échouer le travail, la file d’attente patiente pendant l’intervalle avant nouvelle tentative et retente l’opération.
Minimum : 0 (nouvelle tentative immédiate) ; maximum : 300 000 (5 minutes) ; par défaut : 1 000 (1 seconde)
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MsgRetryLimit
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Si le traitement d’un travail échoue en raison de problèmes temporaires, tels qu’un blocage SQL, la file d’attente redémarre le travail au lieu de le faire échouer. Le nombre de nouvelles tentatives dépend du nombre limite de nouvelles tentatives.
Minimum : 0 (aucune nouvelle tentative) ; maximum : 100 ; par défaut : 5
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-NetTcpPort
Applicable : Project Server 2016, Project Server 2019
Définit le port TCP utilisé par le service File d’attente du projet.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PeriodicTasksInterval
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Un certain nombre de tâches de comptabilité sont exécutées par le système de file d’attente. Par exemple, vous pouvez réveiller des travaux à l’état « Veille », mettre à jour l’horodatage des pulsations, vérifier si le nettoyage de file d’attente doit être exécuté, etc. Ce paramètre contrôle l’intervalle de temps auquel ces tâches s’exécutent.
Minimum : 500 (1/2 seconde) ; maximum : 300 000 (5 minutes) ; par défaut : 10 000 (10 secondes)
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-QueueTimeout
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Le système de mise en file d’attente est doté d’une fonction de récupération avec basculement. Si la batterie contient plusieurs serveurs exécutant le service d’application Project Server et que le service de file d’attente échoue sur un serveur, les travaux sont automatiquement redistribués aux autres serveurs sur lesquels le service de file d’attente est en ligne. On considère qu’un service de mise en file d’attente expire s’il est inaccessible à partir du travail du minuteur Fonctionnement de la file d’attente pendant une durée supérieure au délai d’expiration de la file d’attente.
Minimum : 5 minutes ; maximum : 60 minutes ; par défaut : 15 minutes
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ServiceApplication
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Spécifie l’application de service Project Server à cibler.
Le type doit être un GUID valide, au format 12345678-90ab-cdef-1234-567890bcdefgh ; nom valide d’une application de service Project Server (par exemple, ProjectServiceApp1) ; ou un instance d’un objet PsiServiceApplication valide.
Propriétés du paramètre
| Type: | PsiServiceApplicationPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | sa |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SqlCommandTimeout
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
La file d’attente effectue des appels SQL pour récupérer et exécuter les travaux. Ce paramètre contrôle la valeur du délai d’attente pour tous les appels de ce type. Si un travail échoue en raison d’une erreur de délai d’attente SQL, l’administrateur peut augmenter ce paramètre et réessayer l’opération.
Minimum : 30 secondes ; maximum : 86 400 (1 jour) ; par défaut : 1 800 (30 minutes)
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SqlRetryInterval
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Si la file d’attente ne parvient pas à se connecter à une base de données Project Web App en raison d’un problème SQL temporaire (comme un interblocage SQL), la file d’attente attend que l’intervalle de nouvelles tentatives SQL s’écoule et réessaye la requête.
Minimum : 0 (nouvelle tentative immédiate) ; maximum : 60 000 (1 minute) ; par défaut : 1 000 (1 seconde)
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SqlRetryLimit
Applicable : Project Server 2013, Project Server 2016, Project Server 2019
Si la file d’attente ne parvient pas à se connecter à une base de données Project Web App en raison d’un problème SQL temporaire (comme un interblocage SQL), la file d’attente retente la requête une fois l’intervalle de nouvelle tentative SQL écoulé. Le nombre de tentatives dépend du nombre limite de tentatives SQL.
Minimum : 0 (aucune nouvelle tentative) ; maximum : 100 ; par défaut : 5
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.