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
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MaxConnections

Применимо: Project Server 2013, Project Server 2016, Project Server 2019

Максимальное число подключений очереди, разрешенных для ожидания распределения на сервере.

По умолчанию: 10

Свойства параметров

Тип:Int32
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-NetTcpPort

Применимо: Project Server 2016, Project Server 2019

Устанавливает TCP-порт, используемый службой очереди проектов.

Свойства параметров

Тип:Int32
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Южная Африка

Наборы параметров

(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
Значение по умолчанию: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
Значение по умолчанию: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
Значение по умолчанию: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.