Acerca de las aplicaciones cliente de acción personalizada de Configuration Manager

La secuencia de tareas de Configuration Manager realiza operaciones de acciones personalizadas durante la implementación del cliente. La aplicación puede ser un proceso, un script u otros comandos. Los requisitos de la aplicación se definen en un archivo de formato de objeto administrado (MOF). Algunos ejemplos de requisitos son el entorno operativo, los argumentos de la línea de comandos, las propiedades y los códigos de retorno. Se agregan al entorno de secuencia de tareas cuando se procesa la acción.

Archivo MOF de acción personalizada

El archivo MOF para una acción personalizada es similar al ejemplo siguiente:

[   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";
};

El archivo MOF describe la información necesaria para la entrada de la aplicación de acción personalizada, el entorno, las propiedades y la información del paquete de implementación.

Para obtener más información, consulta Acerca del archivo MOF de acción personalizada de Configuration Manager.

Entrada de la aplicación

Las acciones personalizadas tienen que ejecutarse desatendidas, por lo que la aplicación no debe solicitar la entrada del usuario. Todas las entradas deben recibirse desde la línea de comandos, el entorno de secuencia de tareas o desde un archivo de datos.

La línea de comandos para la aplicación de acción se establece, en el archivo MOF, mediante la acción integrada Ejecutar línea de comandos .

Por ejemplo:

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

Procesamiento de la aplicación

La aplicación de secuencia de tareas ejecuta las operaciones de acción personalizada. Debe ser consciente de su entorno operativo y tener acceso a las variables de entorno de secuenciación de tareas, el progreso de los informes y los códigos de finalización de devolución.

Entorno

El archivo MOF debe especificar el entorno operativo con la propiedad de claseSupportedEnvironment WMI de SMS_TaskSequence_Action Server. Los entornos disponibles son Windows PE (WinPE), sistema operativo completo (FullOS) o ambos entornos (WinPEandFullOS).

La elección del entorno depende de las circunstancias. Por ejemplo, la configuración de la instalación preoperativa probablemente se realizará en el entorno de Windows PE. Para obtener más información, consulte Requisitos de infraestructura para la implementación del sistema operativo. Las novedades de los sistemas operativos instalados actualmente usarán el entorno de sistema operativo completo. Por ejemplo, la instalación de software o controladores. Las tareas independientes del entorno del sistema operativo, como los reinicios o la creación de conexiones de red, se pueden realizar mediante ambas configuraciones de entorno.

Procesamiento

Durante el proceso, tiene acceso a las variables de secuencia de tareas definidas por el archivo MOF utilizando el TSEnvironment objeto de automatización COM. Para obtener más información, consulta Cómo usar variables de secuencia de tareas en una secuencia de tareas de Configuration Manager en ejecución.

Si la operación tarda mucho tiempo, puede notificar el progreso al entorno de secuencia de tareas y mostrar un indicador de progreso mediante la clase de automatización COM de cliente ProgressUI. Para obtener más información, consulta Acerca de cómo notificar el progreso de las acciones personalizadas de Configuration Manager.

Finalización

La aplicación debe establecer la variable de SuccessCodes entorno como valor devuelto cuando se complete.

Si es necesario reiniciar una vez finalizada la aplicación, se debe configurar la variable de SMSTSRebootRequested entorno. Para obtener más información, vea Variables de secuencia de tareas. Para obtener información acerca de cómo configurar variables de entorno, vea Cómo usar variables de secuencia de tareas en una secuencia de tareas de Configuration Manager en ejecución.

Implementación

Para que la use Configuration Manager, la aplicación de acción personalizada debe estar disponible en un paquete de Configuration Manager. El administrador puede crear el paquete si usa la consola de Configuration Manager o un lenguaje de programación. Para obtener más información, consulte Cómo crear un paquete.

El identificador del paquete debe estar disponible para que la implementación funcione. Normalmente, el archivo MOF declara una propiedad para contenerla, como en el ejemplo siguiente:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

El identificador del paquete se obtiene del administrador, cuando la acción personalizada se edita en el editor de secuencia de tareas.

Para habilitar este comportamiento, el control de acción personalizada puede usar un control de edición de texto en su implementación para obtener el identificador del paquete del administrador. Para obtener un ejemplo que utiliza un control de texto, vea Cómo crear un control de acción personalizada de Configuration Manager.

Cuando lo usa el administrador, el control de acción personalizado se edita como parte de una secuencia de tareas mediante el editor de secuencia de tareas. Cuando el editor de secuencias de tareas guarda, se crea una clase WMI de servidor SMS_TaskSequencePackage para contener la secuencia de tareas, incluida la acción personalizada.

A continuación, el paquete de secuencia de tareas se anuncia a los clientes junto con el paquete de acciones personalizado al que hace referencia la acción personalizada. Para obtener más información, consulte Cómo crear un anuncio.

Cuando se ejecuta la acción personalizada en el cliente, el identificador de paquete para la acción personalizada se proporciona como parámetro de línea de comandos, desde el que se extraen y ejecutan los archivos binarios de la acción personalizada.

El identificador del paquete se proporciona mediante el /run parámetro de línea de comandos para Smsswd.exe.

Configuración previa a la partición de red y a la partición

Si necesita configurar la conectividad de disco o red antes de tener una partición de disco y antes de tener conectividad de red, debe crear una aplicación para realizar estas tareas. La aplicación debe colocarse en una imagen de arranque personalizada mediante el Windows Assessment and Deployment Kit (ADK). Para obtener más información, consulte escenarios de Windows ADK para profesionales de TI.

A continuación, importe la imagen en Configuration Manager como una imagen personalizada. Para obtener más información, consulte Agregar una imagen de arranque.

La aplicación, los archivos auxiliares y el SMSTS.INI personalizado deben colocarse en la carpeta Windows.

Para utilizar la aplicación, use la imagen de arranque personalizada en una secuencia de tareas que contenga un paso de red o partición previa.

Vea también

Información de acciones personalizadas de Configuration Manager

Acerca del archivo MOF de acción personalizada de Configuration Manager