Встроенные переменные последовательности задач в Configuration Manager

 

Применимо к:System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 Configuration Manager SP2, System Center 2012 R2 Configuration Manager, System Center 2012 R2 Configuration Manager SP1

Встроенные переменные последовательности задач предоставляются System Center 2012 Configuration Manager. Встроенные переменные содержат данные о среде, в которой выполняется последовательность задач, и их значения доступны на протяжении работы всей последовательности задач. Обычно встроенные переменные инициализируются перед запуском шагов последовательности задач. Например, встроенная переменная _SMSTSLogPath является переменной среды, она указывает путь, который может использоваться компонентами Configuration Manager для записи файлов журналов во время выполнения последовательности задач; эта переменная среды доступна любому шагу последовательности. Однако некоторые переменные, такие как "_SMSTSCurrentActionName", задаются перед каждым шагом. Значения встроенных переменных обычно доступные только для чтения. Значения читаются только для встроенных переменных с именем, которое начинается со знака подчеркивания.

Список встроенных переменных последовательности задач

В следующем списке описаны встроенные переменные, которые доступны в Configuration Manager:

Имя встроенной переменной	Описание
_SMSTSAdvertID	Содержит уникальный идентификатор развертывания текущей выполняемой последовательности задач. Используется тот же формат, что и для идентификатора развертывания распространения программного обеспечения Configuration Manager. Если последовательность задач выполняется с автономного носителя, эта переменная не задается. Пример. ABC20001
_TSAppInstallStatus	Для System Center 2012 R2 Configuration Manager и более поздних версий: последовательность задач задает переменную _TSAppInstallStatus со значением состояния установки приложения на шаге последовательности задач "Установка приложения". Последовательность задач задает переменной одно из следующих значений: Неопределено: задается, если шаг последовательности задач "Установить приложение" не был выполнен. Ошибка. задается в случае сбоя как минимум одного приложения из-за ошибки на шаге последовательности задач "Установить приложение". Предупреждение: задается при отсутствии ошибок на шаге последовательности задач "Установить приложение", но когда не выполнена установка одного или нескольких приложений или необходимой зависимости из-за несоответствия требованиям. Успешно: задается при отсутствии ошибок или предупреждений во время выполнения шага последовательности задач "Установить приложение".
_SMSTSBootImageID	Если пакет загрузочного образа связан с текущей выполняемой последовательностью задач, содержит идентификатор пакета загрузочного образа Configuration Manager. При отсутствии связанного пакета загрузочного образа Configuration Manager эта переменная не задается. Пример. ABC00001
_SMSTSBootUEFI	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: Последовательность задач задает переменную SMSTSBootUEFI при обнаружении компьютера, находящегося в режиме UEFI.
_SMSTSClientGUID	Содержит значение GUID клиента Configuration Manager. Если последовательность задач выполняется с автономного носителя, эта переменная не задается. Пример. 0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c
_SMSTSCurrentActionName	Задает имя текущего выполняемого шага последовательности задач. Эта переменная задается перед запуском диспетчером последовательностей задач каждого из шагов. Пример. выполнить из командной строки
_SMSTSDownloadOnDemand	Значение true (истина) устанавливается, если текущая последовательность задач выполняется в режиме загрузки по требованию. Это означает, что диспетчер последовательности задач загружает содержимое в локальное расположение только тогда, когда требуется доступ к этому содержимому.
_SMSTSInWinPE	Для этой переменной устанавливается значение true (истина), если текущий шаг последовательности задач выполняется в среде предустановки Windows, и значение false (ложь) в противном случае. Проверив значение этой переменной последовательности задач, можно определить текущую среду операционной системы.
_SMSTSLastActionRetCode	Содержит код возврата, возвращенный последним выполненным действием. Эта переменная может использоваться в качестве условия для определения того, запущен ли следующий шаг. Пример. 0
_SMSTSLastActionSucceeded	Эта переменная принимает значение true (истина), если предыдущее действие выполнено успешно, или false (ложь), если последнее действие завершилось со сбоем. Если последнее действие было пропущено из-за того, что этот шаг был отключен или связанное с ним условие было принято со значением false (ложь), эта переменная не сбрасывается, т. е. она содержит значение для предыдущего действия.
_SMSTSLaunchMode	Задает метод запуска последовательности задач. Последовательность задач может иметь следующие значения: SMS — указывает, что последовательность задач запущена с использованием клиента Configuration Manager. UFD — указывает, что последовательность задач запущена с помощью USB-носителя, и что этот носитель создан в Windows XP или Windows Server 2003. UFD+FORMAT — указывает, что последовательность задач запущена с помощью USB-носителя, и что этот носитель создан в Windows Vista или более поздней версии. CD — указывает, что последовательность задач запущена с помощью компакт-диска. DVD — указывает, что последовательность задач запущена с помощью DVD-диска. PXE — указывает, что последовательность задач запущена с PXE. HD — указывает, что последовательность задач была запущена с жесткого диска (только для предварительно подготовленных носителей).
_SMSTSLogPath	Содержит полный путь к папке журнала. Эту переменную можно использовать для определения расположения журнала действий. Если жесткий диск недоступен, это значение не устанавливается.
_SMSTSMachineName	Содержит и указывает имя компьютера. Содержит имя компьютера, который будет использоваться последовательностью задач для регистрации всех сообщений об изменении состояния. Для изменения имени компьютера в новой операционной системе используйте переменную OSDComputerName. Пример. ABC
_SMSTSMDataPath	Задает путь, определенный в переменной SMSTSLocalDataDrive. Если определить переменную SMSTSLocalDataDrive перед запуском последовательности задач, например задав переменную коллекции, то Configuration Manager определит переменную _SMSTSMDataPath в момент запуска последовательности задач.
_SMSTSMediaType	Указывает тип носителя, используемого для инициализации установки. Примерами типов носителя могут быть загрузочный носитель, полный носитель, PXE и предварительно подготовленный носитель.
_SMSTSMP	Содержит имя или IP-адрес точки управления Configuration Manager.
_SMSTSMPPort	Содержит номер порта точки управления Configuration Manager. Пример. 80
_SMSTSOrgName	Содержит название организации, отображающееся в диалоговом окне пользовательского интерфейса хода выполнения последовательности задач. Пример. Организация АБВ
_SMSTSPackageID	Содержит идентификатор текущей выполняемой последовательности задач. В этом идентификаторе используется тот же формат, что и в идентификаторе пакета программного обеспечения Configuration Manager. Пример. HJT00001
_SMSTSPackageName	Содержит имя текущей выполняемой последовательности задач, заданное администратором Configuration Manager при создании последовательности задач. Пример. Последовательность задач развертывания Windows 7
_SMSTSRunFromDP	Значение true означает, что текущая последовательность задач выполняется в режиме выполнения из точки распространения; т. е. диспетчер последовательностей задач получает требуемые пакеты из точки распространения.
_SMSTSSiteCode	Содержит код сайта Configuration Manager. Пример. ABC
_SMSTSType	Задает тип текущей выполняемой последовательности задач. Возможны следующие значения: 1 — означает обычную последовательность задач. 2 — означает последовательность задач развертывания операционной системы.
_SMSTSTimezone	В переменной _SMSTSTimezone сохраняются данные о часовом поясе в следующем формате (без пробелов): Bias, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName Пример. Для Восточного времени (США и Канада) значение будет иметь вид 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Eastern Standard Time,Eastern Daylight Time
_SMSTSUseCRL	Указывает, использует ли последовательность задач список отзыва сертификатов, если для связи с точкой управления используется сертификат SSL.
_SMSTSUserStarted	Указывает, запущена ли последовательность задач пользователем. Эта переменная задается только в том случае, если последовательность задач запускается из центра программного обеспечения. Например, если для переменной _SMSTSLaunchMode задано значение SMS. Эта переменная может принимать следующие значения: true (истина) — указывает, что последовательность задач запущена пользователем вручную из центра программного обеспечения. false (ложь) — указывает, что последовательность задач запущена автоматически планировщиком Configuration Manager.
_SMSTSUseSSL	Указывает, использует ли последовательность задач SSL для связи с точкой управления Configuration Manager. Если сайт работает в основном режиме, устанавливается значение true (истина).
_SMSTSWTG	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: определяет, работает ли компьютер как устройство Windows To Go.
SMSTSAssignmentsDownloadInterval	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: Используйте эту переменную, чтобы указать время ожидания в секундах перед новой попыткой клиента загрузить политику с момента последней попытки, не вернувшей политик. По умолчанию клиент ожидает 0 секунд перед повторной попыткой. Эту переменную можно установить с помощью команды перед запуском с носителя или посредством PXE.
SMSTSAssignmentsDownloadRetry	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: Используйте эту переменную, чтобы указать количество попыток загрузки политики, выполняемых клиентом, если политики не были найдены с первой попытки. По умолчанию клиент повторяет попытку 0 раз. Эту переменную можно установить с помощью команды перед запуском с носителя или посредством PXE.
SMSTSAssignUsersMode	Указывает, как последовательность задач связывает пользователей с конечным компьютером. Присвойте переменной одно из следующих значений. Auto (Автоматически). Последовательность задач создает связь между определенными пользователями и конечным компьютером во время развертывания операционной системы на конечный компьютер. Pending (Ожидание). Последовательность задач создает связь между определенными пользователями и конечным компьютером, но перед применением этой связи ожидает утверждения от пользователя с правами администратора. Disabled (Отключено). Последовательность задач не связывает пользователей с конечным компьютером во время развертывания операционной системы.
SMSTSDownloadProgram	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: С помощью этой переменной можно задать в последовательности задач альтернативного поставщика содержимого (программы для загрузки содержания) вместо стандартного средства загрузки Configuration Manager. Во время загрузки содержимого последовательность задач проверяет, указана ли в этой переменной программа для загрузки. Если программа указана, последовательность задач выполняет программу для загрузки.
SMSTSDownloadRetryCount	Для System Center 2012 R2 Configuration Manager и более поздних версий: используйте эту переменную для задания числа попыток Configuration Manager загрузки содержимого из точки распространения. По умолчанию клиент повторяет попытку 2 раза.
SMSTSDownloadRetryDelay	Для System Center 2012 R2 Configuration Manager и более поздних версий: используйте эту переменную для задания времени ожидания в секундах Configuration Manager перед повторной попыткой загрузки содержимого из точки распространения. По умолчанию клиент ожидает 15 секунд перед повторной попыткой.
SMSTSErrorDialogTimeout	При возникновении ошибки в последовательности задач отображается диалоговое окно, которое автоматически закрывается через количество секунд, указанных в этой переменной. По умолчанию диалоговое окно автоматически закрывается через 900 секунд (15 минут).
TSErrorOnWarning	Для System Center 2012 R2 Configuration Manager и более поздних версий: Используйте эту переменную, чтобы указать, рассматривает ли подсистема выполнения последовательности задач обнаруженное предупреждение как ошибку во время выполнения шага последовательности задач установки приложения. Эта последовательность задач устанавливает переменную _TSAppInstallStatus в значение Warning, если хотя бы одно приложение или требуемая зависимость не устанавливается из-за несоответствия требованиям. Если переменная TSErrorOnWarning имеет значение True, а переменная _TSAppInstallStatus устанавливается в значение Warning, то предупреждение рассматривается как ошибка. Значение False задает поведение по умолчанию.
SMSTSLanguageFolder	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: С помощью этой переменной можно изменять язык отображения информации в загрузочных образах, не зависящих от языка.
SMSTSLocalDataDrive	Указывает место хранения временных файлов на целевом компьютере при выполнении последовательности задач. Эта переменная должна быть задана перед запуском последовательности задач, например посредством задания переменной коллекции.Configuration Manager определяет переменную _SMSTSMDataPath после запуска последовательности задач.
SMSTSMPListRequestTimeout	Для System Center 2012 R2 Configuration Manager и более поздних версий: Используйте эту переменную, чтобы указать для последовательности задач время ожидания в миллисекундах перед повторной попыткой установки приложения после его сбоя при получении списка точек управления из служб обнаружения расположения. По умолчанию последовательность задач ожидает 60 000 миллисекунд (60 секунд), прежде чем повторяет этот шаг, и может выполнять до трех повторных попыток. Эта переменная применима только к шагу последовательности задач "Установка приложения".
SMSTSPersistContent	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: С помощью этой переменной можно временно хранить содержимое в кэше последовательности задач.
SMSTSPostAction	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: Задает команду, которая выполняется после завершения последовательности задач. Например, вы можете использовать эту переменную для указания скрипта, который включает фильтры записи на встраиваемых устройствах после того, как последовательность задач развернет операционную систему на устройстве.
SMSTSPreferredAdvertID	Принудительно запускает на конечном компьютере определенное целевое развертывание. Эта переменная может быть задана с помощью команды перед запуском с носителя или посредством PXE. Если эта переменная задана, последовательность задач переопределяет все обязательные развертывания.
OSDPreserveDriveLetter	Для System Center 2012 Configuration Manager с пакетом обновления 1 (SP1) и более поздних версий: Эта переменная определяет, использует ли последовательность задач букву диска, записанную в WIM-файле образа операционной системы, при применении этого образа на целевом компьютере. В Configuration Manager без пакета обновления буква диска, записанная в WIM-файле, использовалась применительно к образу операционной системы в этом файле. В Configuration Manager с пакетом обновления 1 (SP1) можно задать для этой переменной значение False, чтобы использовать расположение, указанное для параметра Назначение на шаге последовательности задач Применить операционную систему. Дополнительные сведения о шаге последовательности задач "Применить операционную систему" см. в разделе Применение образа операционной системы статьи Шаги последовательности задач в Configuration Manager.
SMSTSRebootDelay	Задает время ожидания в секундах перед перезагрузкой компьютера. Если значение этой переменной отличается от 0, перед перезагрузкой компьютера диспетчер последовательности задач отображается диалоговое окно с предупреждением. Примеры: 0 30
SMSTSRebootMessage	Задает сообщение, отображаемое в диалоговом окне выключения при запросе перезагрузки. Если эта переменная не задана, отображается сообщение по умолчанию. Пример. Этот компьютер перезагружается диспетчером последовательностей задач.
SMSTSRebootRequested	Указывает, что после выполнения текущего шага последовательности задач требуется перезагрузка. Если требуется перезагрузка, просто установите для этой переменной значение true (истина), и диспетчер последовательностей задач перезагрузит компьютер после этого шага последовательности задач. Шаг должен присвоить значение этой переменной последовательности задач, если для завершения его выполнения требуется перезагрузка. После перезагрузки компьютера выполнение последовательности задач продолжится со следующего шага.
SMSTSRetryRequested	Запрашивает повторную попытку после завершения текущего шага последовательности задач. Если установлена эта переменная последовательности задач, для параметра SMSTSRebootRequested также должно быть задано значение true (истина). После перезагрузки компьютера диспетчер последовательности задач вернется к тому же шагу последовательности задач.
SMSTSUDAUsers	указывает основного пользователя конечного компьютера. Укажите пользователей, используя следующий формат. Разделите нескольких пользователей с помощью запятой (,). Пример. домен\пользователь1, домен\пользователь2, домен\пользователь3 Дополнительные сведения о связывании пользователей с конечным компьютером см. в статье Связывание пользователей с конечным компьютером.

См. также

Переменные последовательностей задач в Configuration Manager