Acerca de Configuration Manager aplicaciones cliente de acciones personalizadas

La secuencia de tareas de Configuration Manager realiza operaciones de acción 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). Entre los requisitos de ejemplo se incluyen el entorno operativo, los argumentos de 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 de 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, vea Acerca de la Configuration Manager archivo MOF de acción personalizada.

Entrada de la aplicación

Las acciones personalizadas tienen que ejecutarse desatendida, 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 de 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 aplicaciones

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

Entorno

El archivo MOF debe especificar el entorno operativo con la propiedad SMS_TaskSequence_Action clase WMI deSupportedEnvironment servidor. 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, es probable que la configuración de instalación previa al funcionamiento se realice en el entorno de Windows PE. Para obtener más información, consulte Requisitos de infraestructura para la implementación del sistema operativo. Novedades a los sistemas operativos instalados actualmente usarán el entorno de sistema operativo completo. Por ejemplo, instalación de software o controlador. Las tareas independientes del entorno del sistema operativo, como reinicios o la creación de conexiones de red, se pueden realizar mediante ambas configuraciones de entorno.

Procesamiento

Durante el procesamiento, tiene acceso a las variables de secuencia de tareas definidas por el archivo MOF mediante el TSEnvironment objeto de automatización COM. Para obtener más información, vea How to Use Task Sequence Variables in a Running Configuration Manager Task Sequence.

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 del cliente ProgressUI. Para obtener más información, vea Acerca de los informes Configuration Manager el progreso de la acción personalizada.

Terminación

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

Return	Descripción
0	Correcto
Distinto de cero	Fracaso

Si se requiere un reinicio una vez finalizada la aplicación, se debe establecer la variable de SMSTSRebootRequested entorno. Para obtener más información, vea Variables de secuencia de tareas. Para obtener información sobre cómo establecer variables de entorno, consulte Uso de variables de secuencia de tareas en una secuencia de tareas Configuration Manager en ejecución.

Implementación

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

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

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Nota:

El identificador del paquete es la propiedad SMS_Package ClasePackageID WMI de servidor.

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 usa un control de texto, vea Cómo crear un Configuration Manager control de acción personalizado.

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 lo guarda el editor de secuencia de tareas, 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 acción personalizado al que hace referencia la acción personalizada. Para obtener más información, vea Cómo crear un anuncio.

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

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

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

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 Kit de evaluación e implementación de Windows (ADK). Para obtener más información, consulte Escenarios de Windows ADK para profesionales de TI.

Nota:

La adición de archivos al archivo de imagen de arranque puede aumentar los requisitos mínimos de RAM y, debido a condiciones de memoria baja, puede provocar un error en las secuencias de tareas de maneras inesperadas.

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

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

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

Vea también

Información de acciones personalizadas de Configuration Manager

Acerca del archivo MOF de acción personalizada Configuration Manager