Compartir a través de

SMS_Advertisement clase WMI de servidor

  • Artículo

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, PackageIDy ProgramName se 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.