Set-SPProjectQueueSettings

Riferimento

Modulo:: SharePointServer

Si applica a:: Project Server 2013, Project Server 2016, Project Server 2019

Imposta il valore di una o più impostazioni della coda di Project Server per un'applicazione di servizio di Project Server specifica.

Sintassi

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

Descrizione

Imposta il valore di una o più impostazioni della coda di Project Server per un'applicazione di servizio di Project Server specifica.

Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per Project Server, vedere la documentazione online all'indirizzo https://go.microsoft.com/fwlink/p/?LinkId=251833 (https://go.microsoft.com/fwlink/p/?LinkId=251833).

Esempio

----------------------ESEMPIO-----------------------

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

In questo esempio viene impostato un valore massimo pari a 6 per il numero di processi che possono essere elaborati contemporaneamente dall'applicazione di servizio specificata.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

Questa impostazione determina dopo quante ore un processo completato con errori (ad esempio Non riuscito ma senza blocco della correlazione) può essere eliminato durante l'esecuzione del processo Pulizia coda. La scadenza di ogni processo viene determinata in base alla data e all'ora di completamento. Se ad esempio un processo viene annullato in data 01/02/2007 alle 22.41 e il processo Pulizia coda viene eseguito in data 02/02/2007 alle 23.55, il processo non verrà eliminato (supponendo che l'opzione Scadenza pulizia per processi con errori sia impostata su 7 giorni). Dal momento che generalmente il numero di processi completati con errori non è alto, l'opzione Scadenza pulizia per processi con errori viene impostata su un valore elevato, pari a 168 (7 giorni).

Minimimo: 1. Massimo: 100000. Predefinito: 168 (7 giorni).

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

Questa impostazione determina dopo quante ore è possibile eliminare i processi riusciti durante l'esecuzione del processo Pulizia coda. La scadenza di un processo viene determinata in base alla data e all'ora di completamento. Se ad esempio un processo viene completato senza errori in data 01/02/2007 alle 22.41 e il processo Pulizia coda viene eseguito in data 02/02/2007 alle 23.55, il processo verrà eliminato (supponendo che l'opzione Scadenza pulizia per processi senza errori sia impostata su 1 giorno). Dal momento che generalmente il numero di processi senza errori è alto, l'opzione Scadenza pulizia per processi senza errori viene impostata su un valore basso, pari a 24 (1 giorno).

Minimimo: 1. Massimo: 100000. Predefinito: 24 (1 giorno).

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

Numero massimo di connessioni alla coda consentite come invio in sospeso sul server.

Predefinito: 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

La coda è di tipo multithread, ovvero possono essere elaborati contemporaneamente più processi. Questa impostazione limita il livello di concorrenza della coda. Si noti che questa impostazione è per ogni applicazione di servizio di Project Server.

Minimimo: 1. Massimo: 10. Predefinito: 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

Se l'elaborazione del processo non riesce a causa di problemi temporanei (come un deadlock SQL), anziché interrompere definitivamente il processo, la coda attenderà che trascorra l'intervallo tra i tentativi e proverà di nuovo a eseguire il processo.

Minimo: 0 (nuovo tentativo immediato). Massimo: 300000 (5 minuti). Predefinito: 1000 (1 secondo).

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

Se l'elaborazione del processo non riesce a causa di problemi temporanei (come un deadlock SQL), anziché interrompere definitivamente il processo, la coda tenterà di eseguire di nuovo il processo. Il numero di tentativi è definito dal valore di Limite tentativi.

Minimo: 0 (nessun tentativo). Massimo: 100. Predefinito: 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

Imposta la porta TCP usata dal servizio Accodamento progetti.

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

Esistono diverse attività di contabilità eseguite dal sistema di code. Alcuni esempi sono il risveglio dei processi nello stato "Sospensione", l'aggiornamento del timestamp dell'heartbeat, il controllo della necessità di eseguire la pulizia della coda e così via. Questa impostazione controlla l'intervallo di tempo in cui vengono eseguite queste attività.

Minimo: 500 (1/2 secondo). Massimo: 300000 (5 minuti). Predefinito: 10000 (10 secondi).

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

Il sistema di coda include una funzionalità di ripristino con failover. Se la farm contiene più server che eseguono il servizio applicazioni di Project Server e il servizio accodamento ha esito negativo in un server, i processi vengono ridistribuiti automaticamente ad altri server in cui il servizio accodamento è online. Si verifica il timeout del servizio di coda quando il processo timer di stato della coda non riesce ad accedere al servizio per un periodo di tempo superiore all'intervallo impostato per 'Timeout coda'.

Minimo: 5 minuti. Massimo: 60 minuti. Predefinito: 15 minuti.

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

Specifica l'applicazione di servizio project server di destinazione.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome valido di un'applicazione di servizio di Project Server (ad esempio, ProjectServiceApp1); o un'istanza di un oggetto PsiServiceApplication valido.

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

La coda esegue le chiamate SQL per il recupero e l'esecuzione dei processi. Questa impostazione controlla il valore di timeout per tali chiamate. Se un processo non riesce a causa di un errore di timeout SQL, gli amministratori possono aumentare questa impostazione e riprovare a eseguire il processo.

Minimo: 30 secondi. Massimo: 86400 (1 giorno). Predefinito: 1800 (30 minuti).

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

Se la coda non riesce a connettersi a un database Project Web App a causa di un problema SQL temporaneo (ad esempio un deadlock SQL), la coda attenderà la scadenza dell'intervallo di tentativi SQL e ritenterà la query.

Minimo: 0 (nuovo tentativo immediato). Massimo: 60000 (1 minuto). Predefinito: 1000 (1 secondo).

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

Se la coda non riesce a connettersi a un database di Project Web App a causa di un problema SQL temporaneo (ad esempio un deadlock SQL), la coda ritenterà la query dopo la scadenza dell'intervallo di tentativi SQL. Il numero di tentativi è definito dal valore di Limite tentativi query SQL.