Set-SPProjectQueueSettings
Задает значение одного или нескольких параметров очереди Project Server для определенного приложения-службы Project Server.
Синтаксис
Default (по умолчанию)
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>]
Описание
Задает значение одного или нескольких параметров очереди Project Server для определенного приложения-службы Project Server.
Разрешения и актуальные сведения о Windows PowerShell для Project Server см. в веб-документации по адресу https://go.microsoft.com/fwlink/p/?LinkId=251833 (https://go.microsoft.com/fwlink/p/?LinkId=251833).
Примеры
ПРИМЕР
Set-SPProjectQueueSettings -ServiceApplication "Project Service Application" -MaxDegreeOfConcurrency 6
В этом примере для числа заданий, которые могут быть обработаны одновременно заданным приложением-службой, задается максимальное значение 6.
Параметры
-AssignmentCollection
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
При использовании параметра Global все объекты содержатся в глобальном хранилище.
Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment, может возникнуть нехватка памяти.
Свойства параметра
| Тип: | SPAssignmentCollection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CleanupNonSuccessAgeLimit
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Этот параметр определяет порог возраста, при котором задание в состоянии завершения с ошибками (например, состояния сбоя и неблокирующей взаимосвязи) может быть очищено при запуске задания по очистке очереди. Возраст задания определяется датой и временем завершения. Если, например, задание отменено 1 февраля 2007 в 22:41, а задание по очистке очереди выполняется 2 февраля в 23:55, то задание не будет очищено, исходя из предположения, что предел возраста для очистки неуспешных заданий составляет 7 дней. Поскольку количество завершенных неуспешных заданий обычно невелико, параметр предела по их возрасту для очистки обычно имеет большое значение 168 (7 дней).
Минимум: 1, максимум: 100000; по умолчанию: 168 (7 дней)
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CleanupSuccessAgeLimit
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Этот параметр определяет порог возраста, при котором выполненные задания могут быть удалены при запуске задания по очистке очереди. Возраст задания определяется датой и временем завершения. Если, например, задание успешно завершено 1 февраля 2007 в 22:41, а задание по очистке очереди выполняется 2 февраля в 23:55, то задание будет очищено, исходя из предположения, что предел возраста для очистки успешных заданий составляет 1 день. Так как количество выполненных заданий обычно велико, параметр предела по их возрасту для очистки обычно имеет малое значение 24 (1 день).
Минимум: 1, максимум: 100000; по умолчанию: 24 (1 день)
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MaxConnections
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Максимальное число подключений очереди, разрешенных для ожидания распределения на сервере.
По умолчанию: 10
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MaxDegreeOfConcurrency
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Очередь имеет многопоточную структуру, которая позволяет одновременно обрабатывать несколько заданий. Этот параметр ограничивает уровень параллелизма очереди. Обратите внимание, что этот параметр предназначен для каждого приложения службы Project Server.
Минимум: 1, максимум: 10; по умолчанию: 4
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MsgRetryInterval
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Если происходит не сбой задания, а сбой его обработки, вызванный временными неполадками (например, взаимоблокировкой SQL), то очередь ждет время, равное интервалу повтора, и запускает задание повторно.
Минимум: 0 (немедленный перезапуск), максимум: 300000 (5 минут), по умолчанию: 1000 (1 секунда)
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MsgRetryLimit
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Если происходит не ошибка задания, а сбой его обработки, вызванный временными неполадками (например, взаимоблокировкой SQL), то очередь запускает задание повторно. Количество повторов ограничено предельным числом повторов.
Минимум: 0 (без перезапусков), максимум: 100, по умолчанию: 5
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NetTcpPort
Применимо: Project Server 2016, Project Server 2019
Задает TCP-порт, используемый службой очереди проектов.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PeriodicTasksInterval
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
В системе очередей имеется несколько выполняемых задач регистрации. Некоторые примеры — пробуждение заданий в спящем состоянии, обновление метки времени пульса, проверка необходимости очистки очереди и т. д. Этот параметр задает интервал времени, с которым выполняются эти задачи.
Минимум: 500 (1/2 секунды), максимум: 300000 (5 минут), по умолчанию: 10000 (10 секунд)
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-QueueTimeout
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
В системе очередей есть функция восстановления отработки отказа. Если ферма содержит несколько серверов, на которых запущена служба приложений Project Server, и служба очередей завершается сбоем на одном сервере, задания автоматически перераспределяются на другие серверы, на которых служба очередей подключена. Считается, что время ожидания службы очередей истекло, если к ней не удается получить доступ из задания таймера работоспособности очереди в течение более интервала "Время ожидания очереди".
Минимум: 5 минут, максимум: 60 минут, по умолчанию: 15 минут
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ServiceApplication
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Указывает целевое приложение службы Project Server.
Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в формате 12345678-90ab-cdef-1234-567890bcdefgh; допустимое имя приложения службы Project Server (например, ProjectServiceApp1); или экземпляр допустимого объекта PsiServiceApplication.
Свойства параметра
| Тип: | PsiServiceApplicationPipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | sa |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SqlCommandTimeout
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Очередь выполняет вызовы SQL для получения и выполнения заданий. Этот параметр управляет значением времени ожидания для подобных вызовов. В случае сбоя любого задания из-за истечения времени ожидания SQL администраторы могут повысить значение этого параметра и повторить попытку.
Минимум: 30 секунд, максимум: 86400 (1 день); по умолчанию: 1800 (30 минут)
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SqlRetryInterval
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Если очереди не удается подключиться к базе данных Project Web App из-за временной проблемы SQL (например, из-за взаимоблокировки SQL), очередь будет ожидать истечения интервала повторных попыток SQL и повторит запрос.
Минимум: 0 (немедленный перезапуск), максимум: 60000 (1 минута), по умолчанию: 1000 (1 секунда)
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SqlRetryLimit
Применимо: Project Server 2013, Project Server 2016, Project Server 2019
Если очереди не удается подключиться к базе данных Project Web App из-за временной проблемы SQL (например, из-за взаимоблокировки SQL), очередь повторит запрос после истечения интервала повторных попыток SQL. Количество повторов ограничено предельным числом повторов SQL-запроса.
Минимум: 0 (без повторов), максимум: 100, по умолчанию: 5
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.