Variables integradas de secuencia de tareas en Configuration Manager

 

Se aplica a: 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 proporciona variables integradas de secuencia de tareas. Las variables integradas proporcionan información sobre el entorno donde se ejecuta la secuencia de tareas, y sus valores están disponibles en la secuencia de tareas completa. Las variables integradas se suelen inicializar antes de que se ejecuten los pasos de la secuencia de tareas. Por ejemplo, la variable integrada _SMSTSLogPath es una variable de entorno que especifica la ruta de acceso que los componentes de Configuration Manager usan para escribir archivos de registro mientras la secuencia de tareas se ejecuta. Cualquier paso de la secuencia de tareas puede tener acceso a esta variable de entorno. Sin embargo, algunas variables (como _SMSTSCurrentActionName) se evalúan antes de cada paso. Los valores de las variables integradas son normalmente de solo lectura. Los valores son de solo lectura en el caso de las variables integradas con un nombre que comienza por un carácter de subrayado.

Lista de variables integradas de tarea secuencia

En la siguiente lista se describen las variables integradas que están disponibles en Configuration Manager:

Nombre de la variable integrada	Descripción
_SMSTSAdvertID	Almacena el id. único de implementación de secuencia de tareas en ejecución. Usa el mismo formato que un id. de implementación de distribución de software de Configuration Manager. Si la secuencia de tareas se está ejecutando desde un medio independiente, esta variable no se define. Ejemplo: ABC20001
_TSAppInstallStatus	Solo para System Center 2012 R2 Configuration Manager y versiones más recientes: la secuencia de tareas establece la variable _TSAppInstallStatus con el estado de la instalación de la aplicación durante el paso de secuencia de tareas de instalar la aplicación. La secuencia de tareas establece la variable con uno de los siguientes valores: Sin definir: se establece cuando no se haya ejecutado el paso de secuencia de tareas de instalar la aplicación. Error: se establece cuando al menos una aplicación produzca un error durante el paso de secuencia de tareas de instalar la aplicación. Advertencia: Se establece cuando no se producen errores durante el paso de la secuencia de la tarea de instalación de la aplicación pero una o más aplicaciones, o una dependencia necesaria, no se instalaron porque no se cumplió un requisito. Correcto: Se establece cuando no se detectan errores o advertencias durante el paso de la secuencia de la tarea de instalación de la aplicación.
_SMSTSBootImageID	Almacena el identificador de paquete de imagen de arranque de Configuration Manager, si hay un paquete de imagen de arranque asociado a la secuencia de tareas que se ejecuta actualmente. La variable no se establecerá si no tiene ningún un paquete de imagen de arranque de Configuration Manager asociado. Ejemplo: ABC00001
_SMSTSBootUEFI	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: La secuencia de tareas establece la variable _SMSTSBootUEFI cuando detecta un equipo que está en modo UEFI.
_SMSTSClientGUID	Almacena el valor del GUID de cliente de Configuration Manager. Esta variable no se establece si la secuencia de tareas se está ejecutando desde un medio independiente. Ejemplo: 0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c
_SMSTSCurrentActionName	Especifica el nombre del paso de la secuencia de tareas actualmente en ejecución. Esta variable se establece antes de que el administrador de la secuencia de tareas ejecute cada paso individual. Ejemplo: ejecutar línea de comandos
_SMSTSDownloadOnDemand	Se establece en true si la secuencia de tareas actual se ejecuta en modo de descarga a petición, lo que significa que el administrador de la secuencia de tareas descarga contenido localmente solo cuando deba tener acceso al contenido.
_SMSTSInWinPE	Esta variable se establece en true si el paso actual de la secuencia de tareas se ejecuta en el entorno de Windows PE y en false si no es así. Esta variable de secuencia de tareas se puede comprobar para saber cuál es el entorno de sistema operativo actual.
_SMSTSLastActionRetCode	Almacena el código de retorno devuelto por la última acción que se ha ejecutado. Esta variable se puede usar como una condición para saber si el siguiente paso se ejecuta. Ejemplo: 0
_SMSTSLastActionSucceeded	La variable se establece en true si la última acción se realizó correctamente y en false si se produjo un error. Si la última acción se omitió porque el paso estaba deshabilitado o la condición asociada se evaluó como false, esta variable no se restablecerá, lo que significa que reflejará el valor de la acción anterior.
_SMSTSLaunchMode	Especifica el método de inicio de la secuencia de tareas. La secuencia de tareas puede tener los valores siguientes: SMS: indica que la secuencia de tareas se inició mediante el cliente de Configuration Manager. UFD: indica que la secuencia de tareas se inició mediante un medio USB y que dicho medio USB se creó en Windows XP/2003. UFD+FORMATO: indica que la secuencia de tareas se inició mediante un medio USB y que dicho medio USB se creó en Windows Vista o posterior. CD: indica que la secuencia de tareas se inició mediante un CD. DVD: indica que la secuencia de tareas se inició mediante un DVD. PXE: indica que la secuencia de tareas se inició desde PXE. HD: indica que la secuencia de tareas se inició desde un disco duro (solo medios preconfigurados).
_SMSTSLogPath	Almacena la ruta de acceso completa del directorio de registro. Esto puede servir para determinar dónde se registran las acciones. Este valor no se establece si no hay una unidad de disco duro disponible.
_SMSTSMachineName	Almacena y especifica el nombre del equipo. Almacena el nombre del equipo que la secuencia de tareas va a usar para registrar todos los mensajes de estado. Para cambiar el nombre del equipo en el nuevo sistema operativo, use la variable OSDComputerName. Ejemplo: ABC
_SMSTSMDataPath	Especifica la ruta de acceso definida por la variable SMSTSLocalDataDrive. Si SMSTSLocalDataDrive se define antes de iniciar la secuencia de tareas (por ejemplo, estableciendo una variable de la colección), Configuration Manager define la variable _SMSTSMDataPath después de que la secuencia de tareas se inicie.
_SMSTSMediaType	Especifica el tipo de medio que se usa para iniciar la instalación. Algunos ejemplos de tipos de medios son medios de arranque, medios completos, PXE y medios preconfigurados.
_SMSTSMP	Almacena el nombre o dirección IP de un punto de administración de Configuration Manager.
_SMSTSMPPort	Almacena el número de puerto de un punto de administración de Configuration Manager. Ejemplo: 80
_SMSTSOrgName	Almacena el nombre de título de personalización de marca que se muestra en el cuadro de diálogo de interfaz de usuario de progreso de una tarea secuencia. Ejemplo: Organización XYZ
_SMSTSPackageID	Almacena el identificador de la secuencia de tareas que se ejecuta actualmente. Este identificador usa el mismo formato que un identificador de paquete de software de Configuration Manager. Ejemplo: HJT00001
_SMSTSPackageName	Almacena el nombre de la secuencia de tareas que se ejecuta actualmente, especificado por el administrador de Configuration Manager cuando se creó la secuencia de tareas. Ejemplo: Implementar secuencia de tareas de Windows 7
_SMSTSRunFromDP	Se establece en true si la secuencia de tareas actual se ejecuta en modo de ejecución desde un punto de distribución, lo que significa que el administrador de la secuencia de tareas obtiene los recursos compartidos de paquete necesarios del punto de distribución.
_SMSTSSiteCode	Almacena el código de sitio del sitio de Configuration Manager. Ejemplo: ABC
_SMSTSType	Especifica el tipo de la secuencia de tareas que se ejecuta actualmente. Puede tener los siguientes valores: 1: indica una secuencia de tareas genérica. 2: indica una secuencia de tareas de implementación de sistema operativo.
_SMSTSTimezone	La variable _SMSTSTimezone almacena la información de zona horaria con el siguiente formato (sin espacios): Bias, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName Ejemplo: el valor de la hora del Este de EE.UU y Canadá sería 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Hora estándar del Este,Hora de verano del Este
_SMSTSUseCRL	Especifica si la secuencia de tareas usa la lista de revocación de certificados cuando usa un certificado de Capa de sockets seguros (SSL) para comunicarse con el punto de administración.
_SMSTSUserStarted	Especifica si un usuario ha iniciado una secuencia de tareas. Esta variable se establece únicamente si la secuencia de tareas se ha iniciado desde el Centro de software. Por ejemplo, si _SMSTSLaunchMode está establecido en SMS. La variable puede tener los siguientes valores: true: indica que un usuario inició la secuencia de tareas manualmente desde el Centro de software. false: indica que el programador de Configuration Manager inició automáticamente la secuencia de tareas.
_SMSTSUseSSL	Especifica si la secuencia de tareas usa SSL para comunicarse con el punto de administración de Configuration Manager. Si el sitio se ejecuta en modo nativo, el valor se establece en true.
_SMSTSWTG	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Especifica si el equipo se ejecuta como un dispositivo Windows To Go.
SMSTSAssignmentsDownloadInterval	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Use esta variable para especificar el número de segundos de espera antes de que el cliente intente descargar la directiva desde el último intento (en el que no se devolvió ninguna directiva). El cliente esperará 0 segundos de forma predeterminada antes de volver a intentarlo. Puede establecer esta variable mediante un comando de preinicio desde un medio o PXE.
SMSTSAssignmentsDownloadRetry	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Use esta variable para especificar el número de veces que un cliente intentará descargar la directiva después de que no se encontraran directivas en el primer intento. El cliente lo volverá a intentar 0 veces de forma predeterminada. Puede establecer esta variable mediante un comando de preinicio desde un medio o PXE.
SMSTSAssignUsersMode	Especifica el modo en que una secuencia de tareas asocia usuarios con el equipo de destino. La variable se establece en uno de los siguientes valores. Automático: la secuencia de tareas crea una relación entre los usuarios especificados y el equipo de destino cuando se implementa el sistema operativo en el equipo de destino. Pendiente: la secuencia de tareas crea una relación entre los usuarios especificados y el equipo de destino, pero espera la aprobación del usuario administrativo antes de establecer la relación. Deshabilitado: la secuencia de tareas no asocia usuarios al equipo de destino cuando se implementa el sistema operativo.
SMSTSDownloadProgram	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Utilice esta variable para especificar un proveedor de contenido alternativo, es decir, un programa que se usa para descargar contenido en vez del programa de descarga de Configuration Manager predeterminado para la secuencia de tareas. Como parte del proceso de descarga de contenido, la secuencia de tareas comprueba si la variable especifica algún programa de descarga. En caso afirmativo, la secuencia de tareas ejecuta el programa para realizar la descarga.
SMSTSDownloadRetryCount	Solo para System Center 2012 R2 Configuration Manager y versiones más recientes: utilice esta variable para especificar el número de veces que Configuration Manager intenta descargar contenido desde un punto de distribución. El cliente lo volverá a intentar 2 veces de forma predeterminada.
SMSTSDownloadRetryDelay	Solo para System Center 2012 R2 Configuration Manager y versiones más recientes: utilice esta variable para especificar el número de segundos que Configuration Manager espera antes de volver a intentar descargar contenido desde un punto de distribución. El cliente esperará 15 segundos de forma predeterminada antes de volver a intentarlo.
SMSTSErrorDialogTimeout	Cuando se produce un error en una secuencia de tareas, se abre un cuadro de diálogo que se cierra automáticamente transcurrido un número de segundos especificado por esta variable. El cuadro de diálogo se cierra automáticamente de forma predeterminada después de 900 segundos (15 minutos).
TSErrorOnWarning	Solo para System Center 2012 R2 Configuration Manager y versiones más recientes: Use esta variable para especificar si el motor de la secuencia de tareas considera una advertencia detectada como un error durante el paso de secuencia de tareas de instalación de la aplicación. La secuencia de tareas establece la variable _TSAppInstallStatus en Advertencia cuando una o más aplicaciones (o una dependencia necesaria) no se instalaron porque no se cumplió un requisito. Cuando la variable TSErrorOnWarning se establece en True y la variable _TSAppInstallStatus se establece en Advertencia, se considera que hay un error. Un valor False es el comportamiento predeterminado.
SMSTSLanguageFolder	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Utilice esta variable para cambiar el idioma de visualización de una imagen de arranque independiente del idioma.
SMSTSLocalDataDrive	Especifica la ubicación donde se almacenan los archivos temporales en el equipo de destino mientras la secuencia de tareas se ejecuta. Esta variable se debe establecer antes de iniciar la secuencia de tareas (por ejemplo, estableciendo una variable de la colección). Una vez que la secuencia de tareas se inicia, Configuration Manager define la variable _SMSTSMDataPath.
SMSTSMPListRequestTimeout	Solo para System Center 2012 R2 Configuration Manager y versiones más recientes: Use esta variable para especificar la cantidad de milisegundos que una secuencia de tareas espera antes de reintentar instalar una aplicación después de no poder recuperar la lista de puntos de administración de servicios de ubicación. La secuencia de tareas espera 60.000 milisegundos (60 segundos) de forma predeterminada antes de reintentar el paso, y realiza un máximo de tres reintentos. Esta variable solo es aplicable para el paso de secuencia de tareas Instalar aplicación.
SMSTSPersistContent	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Utilice esta variable para conservar temporalmente contenido en la memoria caché de la secuencia de tareas.
SMSTSPostAction	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Especifica un comando que se ejecuta una vez completada la secuencia de tareas. Por ejemplo, puede usar esta variable para especificar un script que permite escribir filtros en los dispositivos incrustados después de la secuencia de tareas implemente un sistema operativo en el dispositivo.
SMSTSPreferredAdvertID	Fuerza la ejecución de una determinada implementación de destino en el equipo de destino. Esto se puede establecer a través de un comando de preinicio desde un medio o PXE. Si esta variable se establece, la secuencia de tareas invalida todas las implementaciones necesarias.
OSDPreserveDriveLetter	Para System Center 2012 Configuration Manager SP1 y versiones posteriores: Esta variable determina si la secuencia de tareas usa o no la letra de unidad capturada en el archivo WIM de imagen del sistema operativo al aplicar esa imagen en un equipo de destino. En Configuration Manager sin Service Pack, se usa la letra de unidad capturada en el archivo WIM al aplicar el archivo WIM de imagen del sistema operativo. En Configuration Manager SP1, puede establecer el valor de esta variable en Falso para usar la ubicación que especifique en el ajuste Destino del paso de la secuencia de tareas Aplicar el sistema operativo. Para más información sobre el paso Aplicar el sistema operativo de la secuencia de tareas, consulte la sección Aplicar imagen de sistema operativo en el tema Pasos de la secuencia de tareas en Configuration Manager.
SMSTSRebootDelay	Especifica el número de segundos que se debe para esperar antes de reiniciar el equipo. Si esta variable no está establecida en 0, el administrador de la secuencia de tareas mostrará un cuadro de diálogo de notificación antes del reinicio. Ejemplos: 0 30
SMSTSRebootMessage	Especifica el mensaje que se va a mostrar en el cuadro de diálogo de apagado cuando se solicita un reinicio. Si esta variable no se establece, aparecerá un mensaje predeterminado. Ejemplo: El administrador de la secuencia de tareas está reiniciando este equipo.
SMSTSRebootRequested	Indica que se ha solicitado el reinicio una vez completado el paso actual de la secuencia de tareas. Si se requiere un reinicio, basta con establecer esta variable en true y el administrador de la secuencia de tareas reiniciará el equipo después de este paso de la secuencia de tareas. El paso de la secuencia de tareas debe establecer esta variable de secuencia de tareas si requiere un reinicio para completarse. Una vez reiniciado el equipo, la secuencia de tareas seguirá ejecutándose desde el paso siguiente de la secuencia de tareas.
SMSTSRetryRequested	Solicita un reintento después de que se haya completado el paso actual de la secuencia de tareas. Si esta variable de secuencia de tareas se establece, SMSTSRebootRequested también debe establecerse en true. Una vez reiniciado el equipo, el administrador de la secuencia de tareas volverá a ejecutar el mismo paso de la secuencia de tareas.
SMSTSUDAUsers	especifica el usuario primario del equipo de destino. Especifique los usuarios con el siguiente formato. Separe varios usuarios con una coma (,). Ejemplo: dominio\usuario1, dominio\usuario2, dominio\usuario3. Para obtener más información acerca de cómo asociar usuarios al equipo de destino, consulte Cómo asociar usuarios a un equipo de destino.

Vea también

Variables de secuencia de tareas en Configuration Manager