SMS_Program clase WMI de servidor

Artículo
04/04/2023

La SMS_Program clase Instrumental de administración de Windows (WMI) es una clase de servidor proveedor de SMS, en Configuration Manager, que representa un programa o comando para ejecutarse cuando el software se distribuye a un equipo cliente.

La sintaxis siguiente se simplifica a partir del código de formato de objeto administrado (MOF) e incluye todas las propiedades heredadas.

Sintaxis

Class SMS_Program : SMS_BaseClass  
{  
     UInt32 ActionInProgress;  
     String ApplicationHierarchy;  
     String CommandLine;  
     String Comment;  
     String DependentProgram;  
     String Description;  
     UInt32 DeviceFlags;  
     String DiskSpaceReq;  
     String DriveLetter;  
     UInt32 Duration;  
     UInt8 ExtendedData[];  
     UInt32 ExtendedDataSize;  
     UInt8 Icon[];  
     UInt32 IconSize;  
     UInt8 ISVData[];  
     UInt32 ISVDataSize;  
     String ISVString;  
     String MSIFilePath  
     String MSIProductID  
     String PackageID;  
     String PackageName  
     UInt32 PackageType  
     String PackageVersion  
     UInt32 ProgramFlags;  
     String ProgramName;  
     String RemovalKey;  
     String Requirements;  
     UInt32 SecuredTypeID  
     SMS_OS_Details SupportedOperatingSystems[];  
     UInt32   TransformReadiness=0;   
     Datetime TransformAnalysisDate;   
     String   TransformDtID;   
     String WorkingDirectory;  
};

Métodos

La SMS_Program clase no define ningún método.

Propiedades

ActionInProgress
Tipo de datos: UInt32

Tipo de acceso: solo lectura

Calificadores: [lectura, enumeración]

Acción actual que se realiza en el paquete asociado al programa por Configuration Manager. Los posibles valores son:

Valor	Descripción
0	NINGUNO
1	UPDATE
2	Añadir
3	DELETE

Use esta propiedad en una cláusula WHERE para filtrar los programas marcados para su eliminación, pero que aún no se han eliminado. Para obtener más información, vea la sección Comentarios más adelante en este tema.

ApplicationHierarchy
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Jerarquía de aplicaciones para el programa. El valor predeterminado es "".

CommandLine
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Línea de comandos que se ejecuta cuando se inicia el programa. El valor predeterminado es "".

Comment
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Comentario que describe el programa en la consola de Configuration Manager. El valor predeterminado es "".

DependentProgram
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Cadena de texto con formato que define cualquier programa que se debe ejecutar antes de ejecutar este programa. El formato se define como <PackageID>;;< NombreDePrograma>. Si el programa está en el mismo paquete, la aplicación que realiza la llamada simplemente puede especificar ;;< NombreDePrograma>. El valor predeterminado es "".

La dependencia solo se mantiene por primera vez que se ejecuta el programa. Una vez ejecutado el programa, se omite la dependencia. Por ejemplo, no se puede crear un trabajo programado periódico para el que se mantenga la dependencia para cada ejecución del programa.

Description
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

No se usa.

DeviceFlags
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Marcas que describen el dispositivo asociado al programa. Los posibles valores son:

Hexadecimal (bit)	Descripción
0x01000000 (24)	Asigne siempre el programa al cliente.
0x02000000 (25)	Asigne solo si el dispositivo está conectado actualmente a una conexión de ancho de banda alto (valor predeterminado superior a 60 KBps).
0x04000000 (26)	Asigne solo si el dispositivo está acoplado, es decir, está conectado a un escritorio que usa ActiveSync.

DiskSpaceReq
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Espacio aproximado en disco que requiere el programa. El formato es "<size><KB| MB| GB>". El valor predeterminado es "".

Esta información se usa en la consola de Configuration Manager y el anuncio para proporcionar alertas sobre los requisitos de espacio en disco del programa. Después, el usuario puede decidir aceptar el anuncio o realizar primero alguna tarea de administración de discos.

DriveLetter
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [SizeLimit("1"), Range("a-z")]

Letra de unidad (un carácter en el intervalo a-z) desde la que se asigna el programa y desde la que se ejecuta. El valor predeterminado es "".

Duration
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Duración aproximada, en minutos, de la ejecución del programa en el equipo cliente. Especifique este valor como un número entero mayor o igual que 0 (valor predeterminado) o como Desconocido (no recomendado). Si la propiedad está establecida en Desconocido, Configuration Manager establece el tiempo de ejecución máximo permitido en 720 minutos (12 horas). Para obtener más información, vea la sección Comentarios más adelante en este tema.

Nota:

En los equipos cliente, el valor especificado para los programas publicados aparece en Run Advertised Programs en Panel de control.

ExtendedData
Tipo de datos: UInt8 Matriz

Tipo de acceso: lectura y escritura

Calificadores: [grande, diferido]

Blob XML para la implementación de imágenes.

ExtendedDataSize
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: [diferido]

Tamaño de datos extendido, en bytes. El valor predeterminado es 0.

Icon
Tipo de datos: UInt8 Matriz

Tipo de acceso: lectura y escritura

Calificadores: [grande]

Información de icono asociada al icono del programa, como se muestra en la consola de Configuration Manager.

IconSize
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: [diferido]

Tamaño, en bytes, del icono del programa. Establezca esta propiedad en 0 para borrar el icono.

ISVData
Tipo de datos: UInt8 Matriz

Tipo de acceso: lectura y escritura

Calificadores: [grande, diferido]

Información que permite a un único ISV almacenar datos relacionados con un SMS_Program objeto.

No hay restricciones ni formatos definidos para los datos de ISV. Sin embargo, es importante no sobrescribir la propiedad una vez establecida la propiedad del ISV. La aplicación debe leer primero los datos existentes en esta propiedad. Si los datos no pertenecen a la aplicación, no se deben modificar. Debe incluir un identificador en los datos del programa para que la propiedad se pueda establecer fácilmente.

ISVDataSize
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: [diferido]

Tamaño, en bytes, de los datos almacenados en ISVData. El valor predeterminado es 0.

ISVString
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: ninguno

Cadena para la extensibilidad del asociado.

MSIFilePath
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Ruta de acceso del archivo del paquete de Windows Installer con el que está asociado el programa. El valor predeterminado es "".

MSIProductID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Identificador de producto del paquete de Windows Installer con el que está asociado el programa. El valor predeterminado es "".

PackageID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [key, Not_null]

Identificador de un paquete existente con el que asociar el programa. Para obtener más información, vea la sección Comentarios más adelante en este tema.

PackageName
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [Ninguno]

Nombre del paquete al que pertenece el programa.

PackageType
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [Ninguno]

Tipo del paquete al que pertenece el programa.

Valor	Descripción
0	Paquete de distribución de software normal.
3	Paquete de controladores.
4	Paquete de secuencia de tareas.
5	Paquete de actualización de software.
6	Paquete de configuración de dispositivo.
257	Paquete de imagen.
258	Paquete de imagen de arranque.
259	Paquete de instalación del sistema operativo.

PackageVersion
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [Ninguno]

La versión del paquete al que pertenece el programa.

ProgramFlags
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: [bits]

Marcas que identifican las características de instalación del programa. A continuación se enumeran los valores posibles. Los valores predeterminados son EVERYUSER, USEUNCPATH, USERCONTEXT y UNATTENDED.

Nota:

Al usar SMS_Program mediante programación, asegúrese de que no hay valores en conflicto seleccionados. Por ejemplo, NOUSERLOGGEDIN y USERCONTEXT no deben usarse juntos.

Los posibles valores son:

Hexadecimal (bit)	Descripción
0x00000001 (0)	AUTHORIZED_DYNAMIC_INSTALL. El programa está autorizado para la instalación dinámica.
0x00000002 (1)	USECUSTOMPROGRESSMSG. La secuencia de tareas muestra un mensaje de interfaz de usuario de progreso personalizado.
0x00000010 (4)	DEFAULT_PROGRAM. Este es un programa predeterminado
0x00000020 (5)	DISABLEMOMALERTONRUNNING. Deshabilita las alertas de MOM mientras se ejecuta el programa.
0x00000040 (6)	MOMALERTONFAIL. Genera una alerta MOM si se produce un error en el programa.
0x00000080 (7)	RUN_DEPENDANT_ALWAYS. Si se establece, siempre se debe ejecutar el dependiente inmediato de este programa.
0x00000100 (8)	WINDOWS_CE. Indica un programa de dispositivo. Si se establece, el programa no se ofrece a los clientes de escritorio.
0x00000200 (9)	Este valor no se usa.
0x00000400 (10)	CUENTA REGRESIVA. No se muestra el cuadro de diálogo de cuenta atrás.
0x00000800 (11)	FORCERERUN. Este valor no se usa.
0x00001000 (12)	DESHABILITADO. El programa está deshabilitado.
0x00002000 (13)	DESATENDIDO. El programa no requiere ninguna interacción del usuario.
0x00004000 (14)	USERCONTEXT. El programa solo se puede ejecutar cuando un usuario ha iniciado sesión.
0x00008000 (15)	ADMINISTRADORES. El programa debe ejecutarse como la cuenta de administrador local.
0x00010000 (16)	EVERYUSER. El programa debe ser ejecutado por todos los usuarios para los que sea válido. Válido solo para trabajos obligatorios.
0x00020000 (17)	NOUSERLOGGEDIN. El programa solo se ejecuta cuando ningún usuario ha iniciado sesión.
0x00040000 (18)	OKTOQUIT. El programa reiniciará el equipo.
0x00080000 (19)	OKTOREBOOT. Configuration Manager reinicia el equipo cuando el programa ha terminado de ejecutarse correctamente.
0x00100000 (20)	USEUNCPATH. Use una ruta de acceso UNC (sin letra de unidad) para acceder al punto de distribución.
0x00200000 (21)	PERSISTCONNECTION. Conserva la conexión a la unidad especificada en la propiedad DriveLetter. No se debe establecer la marca de bits USEUNCPATH.
0x00400000 (22)	RUNMINIMIZED. Ejecute el programa como una ventana minimizada.
0x00800000 (23)	RUNMAXIMIZED. Ejecute el programa como una ventana maximizada.
x010000000 (24)	HIDEWINDOW. Ocultar la ventana del programa.
0x02000000 (25)	OKTOLOGOFF. Cierre la sesión del usuario cuando el programa se complete correctamente.
0x04000000 (26)	RUNACCOUNT. Este valor no se usa.
0x08000000 (27)	ANY_PLATFORM. Invalide la comprobación de compatibilidad con la plataforma.
0x10000000 (28)	STILL_RUNNING. Este valor no se usa.
0x20000000 (29)	SUPPORT_UNINSTALL. Ejecute la desinstalación desde la clave del Registro cuando expire el anuncio.
0x40000000 (30)	No se admite la plataforma.
0x80000000 (31)	SHOW_IN_ARP. Este valor no se usa.

ProgramName
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [key, Not_null]

Nombre único que representa este programa.

RemovalKey
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Clave del Registro que identifica el script de desinstalación para el programa. El script debe residir en la ruta de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall acceso del Registro. El valor predeterminado es "".

Requirements
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Descripción de los requisitos adicionales del programa. El valor predeterminado es "".

SecuredTypeID
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: [Ninguno]

Tipo protegido de paquete relacionado.

SupportedOperatingSystems
Tipo de datos: SMS_OS_Details Matriz

Tipo de acceso: lectura y escritura

Calificadores: [diferido]

SMS_OS_Details objetos de clase WMI de servidor que representan los sistemas operativos en los que se puede ejecutar el programa.

Si no especifica ANY_PLATFORM en la ProgramFlags propiedad , debe especificar uno o varios sistemas operativos compatibles. SMS_SupportedPlatforms clase WMI de servidor define la lista de plataformas que admite Configuration Manager.

TransformAnalysisDate
Tipo de datos: DateTime

Tipo de acceso: lectura y escritura

Calificadores: [Ninguno]

Únicamente para uso interno.

TransformDtID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [Ninguno]

Únicamente para uso interno.

TransformReadiness
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: [Ninguno]

Únicamente para uso interno.

WorkingDirectory
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Ubicación desde la que se ejecuta el programa. El valor predeterminado es "".

El directorio de trabajo puede ser una ruta de acceso absoluta en el cliente o una ruta de acceso relativa a la carpeta del punto de distribución que contiene el paquete. Si no se especifica un directorio de trabajo, Configuration Manager usa la carpeta de punto de distribución predeterminada.

Comentarios

No hay calificadores de clase especiales para esta clase. Para obtener más información sobre los calificadores de clase y los calificadores de propiedad incluidos en la sección Propiedades, vea Configuration Manager Calificadores de clase y propiedad.

Un programa siempre está asociado a un paquete primario y normalmente representa el programa de instalación del paquete. Tenga en cuenta que más de un programa se puede asociar con el mismo paquete. La aplicación usa la PackageID propiedad para realizar esta asociación. La aplicación no puede cambiar esta propiedad después de crear el SMS_Program objeto. Para asociar el programa a otro paquete, la aplicación debe eliminar el objeto y crear un nuevo objeto con un nuevo PackageID valor.

Cuando la aplicación elimina un SMS_Program objeto, no se elimina hasta que se eliminan sus componentes relacionados, como sus anuncios. En su lugar, Configuration Manager establece la ActionInProgress propiedad en DELETE (3) para marcar el programa para su eliminación. Para asegurarse de que una consulta no recupera programas marcados para su eliminación, agregue este caso a la cláusula WHERE.

Importante

Si usa ventanas de mantenimiento para la colección en la que se ejecuta el programa, puede producirse un conflicto si el valor de la Duration propiedad es mayor que la ventana de mantenimiento programada. Si esta propiedad se establece en Desconocido, el programa se inicia durante la ventana de mantenimiento, pero continúa ejecutándose hasta que se completa o produce un error después de cerrar la ventana de mantenimiento.

Se recomienda no establecer la Duration propiedad en Unknown porque esta propiedad se usa para los dos propósitos importantes siguientes:

Para supervisar los resultados del programa.
Para determinar si el programa se iniciará cuando se hayan definido ventanas de mantenimiento en los equipos cliente.

Si la aplicación establece la propiedad pero el Duration tiempo de ejecución del programa supera esta duración, Configuration Manager deja de supervisar el programa pero no finaliza el programa. Esto permite que Configuration Manager continúe con otras funciones de distribución de software, como ejecutar otros programas anunciados. El administrador no:
Detenga el programa.
Libere todas las unidades asignadas para el programa anunciado.
Libere las conexiones de red realizadas para el programa anunciado.
Recursos gratuitos del sistema operativo utilizados por Configuration Manager cuando se ejecutan programas anunciados.

Para obtener más información, vea Acerca de Las ventanas de mantenimiento.

Requisitos

Requisitos del entorno de ejecución

Para obtener más información, consulte requisitos de tiempo de ejecución de Configuration Manager Server.

Requisitos de desarrollo

Para obtener más información, consulte requisitos de desarrollo de Configuration Manager Server.

Consulta también

SMS_Package clase WMI de servidor
Cómo crear un paquete
Cómo crear un programa

Compartir a través de

SMS_Program clase WMI de servidor

Sintaxis

Métodos

Propiedades

Comentarios

Requisitos

Requisitos del entorno de ejecución

Requisitos de desarrollo

Consulta también

Comentarios

Recursos adicionales