Сведения о клиентских приложениях Configuration Manager пользовательских действий

Статья
04/04/2023

Последовательность задач в Configuration Manager выполняет пользовательские операции действий во время развертывания клиента. Приложение может быть процессом, скриптом или другими командами. Требования к приложению определяются в MOF-файле. Примеры требований включают операционную среду, аргументы командной строки, свойства и коды возврата. Они добавляются в среду последовательности задач при обработке действия.

MOF-файл пользовательского действия

MOF-файл для настраиваемого действия аналогичен следующему примеру:

[   CommandLine("smsswd.exe /run:%1 abc.exe %2"),
    : (custom ui control and category qualifiers for action)
    ]
class MyCustomAction : SMS_TaskSequence_Action
{
    [TaskSequencePackage, CommandLineArg(1)]
    string          PackageIDForAbcExe;

    [CommandLineArg(2), AllowedLen("1-32000")]
    string          AbcCommandLineArgs;

    [SuccessCodes, Not_Null]
    string          AbcSuccessCodes = "0 3010";

    string         SomeOtherPropertyThatAbcNeeds;

    string          SupportedEnvironment = "WinPEandFullOS";
};

В MOF-файле описываются сведения, необходимые для входных данных приложения пользовательского действия, среды, свойств и сведений о пакете развертывания.

Дополнительные сведения см. в разделе Сведения о MOF-файле пользовательского действия Configuration Manager.

Входные данные приложения

Пользовательские действия должны выполняться автоматически, поэтому приложение не должно запрашивать ввод данных пользователем. Все входные данные должны быть получены из командной строки, среды последовательности задач или из файла данных.

Командная строка для приложения действий задается в MOF-файле с помощью встроенного действия Выполнить в командной строке .

Например:

CommandLine("smsswd.exe /run:PackageID abc.exe [any abc.exe command line args]"

Обработка приложений

Приложение последовательности задач выполняет пользовательские операции действий. Он должен знать о своей операционной среде и иметь доступ к переменным среды виртуализации задач, сообщать о ходе выполнения и возвращать коды завершения.

Среда

В MOF-файле должна быть указана операционная среда со свойством класса SupportedEnvironmentWMI сервера SMS_TaskSequence_Action. Доступные среды: Windows PE (WinPE), полная операционная система (FullOS) или обе среды (WinPEandFullOS).

Выбор среды зависит от обстоятельств. Например, предварительная настройка установки, скорее всего, будет выполнена в среде Windows PE. Дополнительные сведения см. в разделе Требования к инфраструктуре для развертывания ОС. Обновления установленных операционных систем будет использовать полную среду операционной системы. Например, установка программного обеспечения или драйвера. Задачи, не зависящие от среды операционной системы, такие как перезагрузка или создание сетевых подключений, могут выполняться с помощью обоих параметров среды.

Обработка

Во время обработки вы обращаетесь к переменным последовательности задач, определенным MOF-файлом, с помощью TSEnvironment объекта автоматизации COM. Дополнительные сведения см. в разделе Использование переменных последовательности задач в выполняемой последовательности задач Configuration Manager.

Если операция занимает много времени, можно сообщить о ходе выполнения в среду последовательности задач и отобразить индикатор хода выполнения с помощью класса COM-автоматизации клиента ProgressUI. Дополнительные сведения см. в разделе Сведения об отчете о ходе выполнения пользовательских действий Configuration Manager.

Завершения

По завершении приложение должно задать SuccessCodes переменную среды в качестве возвращаемого значения.

Возврат	Описание
0	Успешно
Ненулевая	Сбоя

Если после завершения работы приложения требуется перезагрузка SMSTSRebootRequested , необходимо задать переменную среды. Дополнительные сведения см. в разделе Переменные последовательности задач. Сведения о настройке переменных среды см. в разделе Использование переменных последовательности задач в выполняемой последовательности задач Configuration Manager.

Развертывание

Для использования Configuration Manager приложение пользовательского действия должно быть доступно из пакета Configuration Manager. Администратор может создать пакет с помощью консоли Configuration Manager или языка программирования. Дополнительные сведения см. в статье Создание пакета.

Идентификатор пакета должен быть доступен для работы развертывания. Как правило, MOF-файл объявляет свойство для его хранения, как показано в следующем примере:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Примечание.

Идентификатор пакета — это свойство класса PackageIDWMI сервера SMS_Package.

Идентификатор пакета получается от администратора при изменении настраиваемого действия в редакторе последовательности задач.

Чтобы включить это поведение, настраиваемый элемент управления действием может использовать элемент управления редактирования текста в своей реализации, чтобы получить идентификатор пакета от администратора. Пример использования текстового элемента управления см. в статье Создание элемента управления пользовательским действием Configuration Manager.

При использовании администратором настраиваемый элемент управления действием редактируется как часть последовательности задач с помощью редактора последовательности задач. При сохранении в редакторе последовательности задач создается класс WMI сервера SMS_TaskSequencePackage для хранения последовательности задач, включая пользовательское действие.

Затем пакет последовательности задач объявляется клиентам вместе с пакетом пользовательского действия, на который ссылается пользовательское действие. Дополнительные сведения см. в статье Создание объявления.

При выполнении настраиваемого действия на клиенте идентификатор пакета для настраиваемого действия предоставляется в виде параметра командной строки, из которого извлекаются и выполняются двоичные файлы для настраиваемого действия.

Идентификатор пакета предоставляется с помощью параметра командной /run строки для Smsswd.exe.

Предварительная сетевая секция и предварительная настройка секционирования

Если необходимо настроить подключение к диску или сети перед тем, как у вас есть раздел диска и перед подключением к сети, необходимо создать приложение для выполнения этих задач. Приложение должно быть помещено в пользовательский образ загрузки с помощью комплекта средств оценки и развертывания Windows (ADK). Дополнительные сведения см. в статье Сценарии Windows ADK для ИТ-специалистов.

Примечание.

Добавление файлов в файл образа загрузки может увеличить минимальные требования к ОЗУ, а из-за нехватки памяти может привести к неожиданному сбою последовательностей задач.

Затем импортируйте изображение в Configuration Manager в качестве пользовательского образа. Дополнительные сведения см. в разделе Добавление образа загрузки.

Приложение, все вспомогательные файлы и пользовательский SMSTS.INI должны быть помещены в папку Windows.

Чтобы использовать приложение, используйте пользовательский образ загрузки в последовательности задач, содержащей шаг перед секцией или сетью.

См. также

Сведения о настраиваемых действиях Configuration Manager

Сведения о MOF-файле пользовательского действия Configuration Manager

Поделиться через