SMS_Advertisement clase WMI de servidor
La SMS_Advertisement clase Instrumental de administración de Windows (WMI) es una clase de servidor proveedor de SMS, en Configuration Manager, que representa un anuncio que se usa para anunciar programas de paquetes de software que están disponibles para ejecutarse en clientes.
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_Advertisement : SMS_BaseClass
{
UInt32 ActionInProgress;
UInt32 AdvertFlags;
String AdvertisementID;
String AdvertisementName;
SMS_ScheduleToken AssignedSchedule[];
Boolean AssignedScheduleEnabled;
Boolean AssignedScheduleIsGMT;
UInt32 AssignmentID;
String CollectionID;
String Comment;
UInt32 DeviceFlags;
DateTime ExpirationTime;
Boolean ExpirationTimeEnabled;
Boolean ExpirationTimeIsGMT;
String HierarchyPath;
Boolean IncludeSubCollection;
UInt8 ISVData[];
UInt32 ISVDataSize;
String ISVString;
UInt32 MandatoryCountdown;
UInt32 OfferType;
String PackageID;
DateTime PresentTime;
Boolean PresentTimeEnabled;
Boolean PresentTimeIsGMT;
UInt32 Priority;
String ProgramName;
UInt32 RemoteClientFlags;
String SourceSite;
UInt32 TimeFlags;
};
Métodos
En la tabla siguiente se enumeran los métodos de la SMS_Advertisement clase .
| Método | Descripción |
|---|---|
| Método GetAdvertisements en la clase SMS_Advertisement | Obtiene los identificadores de anuncio destinados al recurso. |
| Método GetNextID en la clase SMS_Advertisement | Recupera el número de identificador que se usará para el siguiente anuncio creado. |
| Método RiskyDeploymentStatusMessage en la clase SMS_Advertisement | Envía un mensaje de estado de advertencia sobre una implementación de usuario a una colección de riesgo. |
| Método SetNextID en la clase SMS_Advertisement | Establece el número de id. que se usará para el siguiente anuncio creado. |
| Método SetSourceSite en la clase SMS_Advertisement | Establece el código fuente del sitio para el anuncio. |
| Método Unlock en la clase SMS_Advertisement | Establece el sitio de origen en el sitio actual, desbloqueando el anuncio. Advertencia: Este método está en desuso. |
Propiedades
ActionInProgress
Tipo de datos: UInt32
Tipo de acceso: solo lectura
Calificadores: [lectura, enumeración]
Acción actual que Configuration Manager realiza en el paquete. Los posibles valores son:
| Valor | Descripción |
|---|---|
| 0 | NINGUNO |
| 1 | UPDATE |
| 2 | Añadir |
AdvertFlags
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: [bits]
Marcas que indican cómo se debe anunciar el anuncio al usuario. A continuación se enumeran los valores posibles. El valor predeterminado es 0.
| Hexadecimal (bit) | Descripción |
|---|---|
| 0x00000020 (5) | INMEDIATA. Anuncie el anuncio al usuario inmediatamente. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Anuncie el anuncio al usuario al iniciar el sistema. |
| 0x00000200 (9) | ONUSERLOGON. Anuncie el anuncio al usuario al iniciar sesión. |
| 0x00000400 (10) | ONUSERLOGOFF. Anuncie el anuncio al usuario al cerrar la sesión. |
| 0x00001000 (12) | OPTIONALPREDOWNLOAD. Si la arquitectura y el idioma seleccionados coinciden con el del cliente, el contenido del paquete se descargará de antemano. |
| 0x00008000 (15) | WINDOWS_CE. El anuncio es para un cliente de dispositivo. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Esta información se aplica a System Center 2012 Configuration Manager SP1 o posterior y System Center 2012 R2 Configuration Manager o posterior. |
| 0x00020000 (17) | DONOT_FALLBACK. No vuelva a los puntos de distribución desprotegidos. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. La secuencia de tareas está disponible para los medios extraíbles y el punto de servicio del entorno de ejecución previo al arranque (PXE). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Invalide las ventanas de mantenimiento al anunciar el anuncio al usuario. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Reinicie fuera de las ventanas de mantenimiento. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Anuncie el anuncio al usuario con Wake On LAN habilitado. |
| 0x00800000 (23) | SHOW_PROGRESS. Anuncie el anuncio al usuario que muestra el progreso de la secuencia de tareas. |
| 0x02000000 (25) | NO_DISPLAY. El usuario no debe ejecutar programas independientemente de la asignación. |
| 0x04000000 (26) | ONSLOWNET. Las asignaciones son obligatorias a través de una conexión de red lenta. |
| 0x10000000 (28) | TARGETTOWINPE. Esta implementación solo se dirige a WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Esta implementación solo se dirige a WinPE, pero se oculta en WinPE. Solo la puede usar la variable TS SMSTSPreferredAdvertID. |
Estas marcas deben coordinarse con las marcas especificadas en la ProgramFlags propiedad del programa anunciado. Por ejemplo, si establece ONUSERLOGOFF, se debe establecer la marca NOUSERLOGGEDIN en el programa. Si la configuración de la marca no coincide, el programa no se anuncia. Para obtener más información, vea SMS_Program clase WMI de servidor.
Establecer IMMEDIATE, ONUSERLOGON o ONUSERLOGOFF o proporcionar un AssignedSchedule valor hace que el programa anunciado sea obligatorio. Un programa obligatorio se ejecuta automáticamente después de que el cliente haya recibido el anuncio. El cliente no puede rechazar ni posponer la instalación.
Establezca los bits NO_DISPLAY y ONSLOWNET solo cuando se establezca el bit IMMEDIATE, ONUSERLOGON o ONUSERLOGOFF o el programa tenga un AssignedSchedule valor.
Establezca NO_DISPLAY cuando no desee que el usuario ejecute programas independientemente de la asignación. Si no estableces esta marca, el anuncio se muestra en la lista de anuncios y se puede ejecutar independientemente de la asignación. El programa puede seguir siendo obligatorio.
Establezca ONSLOWNET cuando las asignaciones sean obligatorias a través de una conexión de red lenta, por ejemplo, cuando un equipo se conecta mediante un módem.
AdvertisementID
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: [key, ResID(801), ResDLL("SMS_RSTT.dll")]
Clave única generada automáticamente que identifica el anuncio. El valor predeterminado es "".
AdvertisementName
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: [Not_null]
Nombre descriptivo único para el anuncio.
AssignedSchedule
Tipo de datos: SMS_ScheduleToken Matriz
Tipo de acceso: lectura y escritura
Calificadores: [max(15), lazy]
SMS_ScheduleToken objetos de clase WMI de servidor que indican la hora en que el anuncio se convierte en obligatorio en los clientes.
AssignedScheduleEnabled
Tipo de datos: Boolean
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
true si la programación definida en la AssignedSchedule propiedad está activa. El valor predeterminado es false.
AssignedScheduleIsGMT
Tipo de datos: Boolean
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
true si la programación definida en la AssignedSchedule propiedad está en tiempo de métrica universal (UMT). El valor predeterminado es false.
AssignmentID
Tipo de datos: UInt32
Tipo de acceso: solo lectura
Calificadores: [leer]
Id. de la asignación asociada al anuncio.
CollectionID
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: [Not_null]
Colección existente a la que se dirige el anuncio.
Comment
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Descripción simple o nota sobre el anuncio. El valor predeterminado es "".
DeviceFlags
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Marcas que describen el dispositivo. A continuación se enumeran los valores posibles. El valor predeterminado es 0.
| 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. |
ExpirationTime
Tipo de datos: DateTime
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Fecha y hora en que el anuncio ya no está disponible para los clientes. El valor predeterminado es 199001010000000.000000+****.
ExpirationTimeEnabled
Tipo de datos: Boolean
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
true si el anuncio expira en el momento indicado por la ExpirationTime propiedad . El valor predeterminado es false.
ExpirationTimeIsGMT
Tipo de datos: Boolean
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
true si la hora definida en la ExpirationTime propiedad está en UMT. El valor predeterminado es false.
HierarchyPath
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Reservado.
IncludeSubCollection
Tipo de datos: Boolean
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
true (valor predeterminado) si el anuncio se anuncia en las subcolecciones de la colección especificada.
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 una SMS_Program instancia. No hay restricciones ni formatos definidos para estos datos. Sin embargo, es importante no sobrescribir la propiedad después de que se haya establecido su propiedad de ISV. Por lo tanto, la aplicación que realiza la llamada debe leer primero los datos existentes en esta propiedad. Si los datos no pertenecen a la aplicación, no se deben modificar. Cualquier ISV o propietario de la aplicación que use esta propiedad debe incluir un identificador en los datos para que la propiedad se pueda establecer fácilmente.
ISVDataSize
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
Tamaño de los datos representados por la ISVData propiedad . El valor predeterminado es 0.
ISVString
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: ninguno
Cadena para la extensibilidad del asociado.
MandatoryCountdown
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Duración, en minutos, para mostrar la cuenta atrás de la programación obligatoria de la notificación del usuario de implementación del sistema operativo. El valor predeterminado es 0.
OfferType
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: [enumeración]
Tipo de anuncio que indica que el anuncio está dirigido a los usuarios.
| Valor | Descripción |
|---|---|
| 0 | Obligatorio |
| 2 | Disponible |
PackageID
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: [Not_null]
Identificador de un paquete existente asociado al anuncio. El valor debe estar en mayúsculas.
PresentTime
Tipo de datos: DateTime
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Fecha y hora en que el anuncio está disponible para los clientes. El valor predeterminado es 199001010000000.000000+****.
PresentTimeEnabled
Tipo de datos: Boolean
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
true(valor predeterminado) si Configuration Manager aplica la hora actual.
PresentTimeIsGMT
Tipo de datos: Boolean
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
true si la hora definida en la PresentTime propiedad está en UMT. El valor predeterminado es false.
Priority
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: [enumeración]
Prioridad utilizada para replicar el anuncio en sitios secundarios. A continuación se enumeran los valores posibles. El valor predeterminado es NORMAL (2).
| Valor | Descripción |
|---|---|
| 1 | ALTO |
| 2 | NORMAL |
| 3 | Bajo |
ProgramName
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: [Not_null]
Programa dentro del paquete especificado (PackageID) que se va a anunciar.
RemoteClientFlags
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: [bits]
Marcas que especifican cómo se debe ejecutar el programa cuando el cliente está conectado local o remotamente a un punto de distribución. A continuación se enumeran los valores posibles. El valor predeterminado es 48.
| Hexadecimal (bit) | Descripción |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Ejecute el programa con la energía de la batería. Este valor no se usa actualmente. |
| 0x00000002 (1) | RUN_FROM_CD. Ejecute el programa desde CD. Este valor no se usa actualmente. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Descargue el programa desde CD. Este valor no se usa actualmente. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Ejecute el programa desde el punto de distribución local. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Descargue el programa desde el punto de distribución local. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. No ejecute el programa si no hay ningún punto de distribución local. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Descargue el programa desde el punto de distribución remoto. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Ejecute el programa desde el punto de distribución remoto. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Descargue el programa a petición desde el punto de distribución local. Esto solo es aplicable a las secuencias de tareas. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Descargue el programa a petición desde el punto de distribución remoto. Esto solo es aplicable a las secuencias de tareas. |
| x000000400 (10) | BALLOON_REMINDERS_REQUIRED. Se requieren recordatorios de globos. |
| 0x00000800 (11) | RERUN_ALWAYS. Vuelva a ejecutar siempre el programa. |
| 0x00001000 (12) | RERUN_NEVER. Nunca vuelva a ejecutar el programa. |
| 0x00002000 (13) | RERUN_IF_FAILED. Vuelva a ejecutar el programa si se produjo un error en la ejecución anteriormente. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Vuelva a ejecutar el programa si la ejecución se realizó correctamente anteriormente. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Esta información se aplica a System Center 2012 Configuration Manager SP1 o posterior y System Center 2012 R2 Configuration Manager o posterior. |
| 0x00020000 (17) | DON'T_FALLBACK Esta información se aplica a System Center 2012 Configuration Manager SP1 o posterior y System Center 2012 R2 Configuration Manager o posterior. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Esta información se aplica a System Center 2012 Configuration Manager SP1 o posterior y System Center 2012 R2 Configuration Manager o posterior. |
SourceSite
Tipo de datos: String
Tipo de acceso: solo lectura
Calificadores: [leer]
Código de sitio de tres letras del sitio donde se origina el anuncio.
TimeFlags
Tipo de datos: UInt32
Tipo de acceso: solo lectura
Calificadores: [lectura, bits]
Reservado para uso interno. Marcas que duplican la información en las propiedades relacionadas con el tiempo. A continuación se enumeran los valores posibles. Por ejemplo, ENABLE_PRESENT se establece cuando PresentTimeEnabled es igual a true.
| Hexadecimal (bit) | Descripción |
|---|---|
| 0x00000001 (0) | ENABLE_PRESENT |
| 0x00000002 (1) | ENABLE_EXPIRATION |
| 0x00000004 (2) | ENABLE_AVAILABLE |
| 0x00000008 (3) | ENABLE_UNAVAILABLE |
| 0x00000010 (4) | ENABLE_MANDATORY |
| 0x00000020 (5) | GMT_PRESENT |
| 0x00000040 (6) | GMT_EXPIRATION |
| 0x00000080 (7) | GMT_AVAILABLE |
| 0x00000100 (8) | GMT_UNAVAILABLE |
| 0x00000200 (9) | GMT_MANDATORY |
Comentarios
Los calificadores de clase para esta clase incluyen:
Protegida
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.
Aunque no hay ninguna otra propiedad clave, las propiedades
AdvertisementName,CollectionID,PackageIDyProgramNamese califican como NOT_NULL y se deben proporcionar valores. La aplicación no puede actualizar estas propiedades después de crear una instancia de clase. Para cambiar estos valores, la aplicación debe eliminar la instancia y crear una nueva instancia con los valores correctos.
Requisitos
Requisitos en tiempo 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.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de