Set-SPProjectQueueSettings

Référence

Module:: sharepoint-server

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.

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>]

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

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.

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

-CleanupNonSuccessAgeLimit

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)

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

-CleanupSuccessAgeLimit

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)

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

-MaxConnections

Nombre maximal de connexions à la file d’attente qui peuvent être en attente de distribution sur le serveur.

Par défaut : 10

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

-MaxDegreeOfConcurrency

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

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

-MsgRetryInterval

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)

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

-MsgRetryLimit

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

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

-NetTcpPort

Définit le port TCP utilisé par le service File d’attente du projet.

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

-PeriodicTasksInterval

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)

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

-QueueTimeout

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

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

-ServiceApplication

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 une instance d’un objet PsiServiceApplication valide.

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

-SqlCommandTimeout

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)

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

-SqlRetryInterval

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)

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

-SqlRetryLimit

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.