SMS_Advertisement clase WMI de servidor

La SMS_Advertisement clase Instrumental de administración de Windows (WMI) es una clase de servidor de 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 los 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.

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:

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. Los valores posibles se enumeran a continuación. El valor predeterminado es 0.

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, consulte 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 ha 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 establece esta marca, el anuncio se muestra en la lista de anuncios y se puede ejecutar independientemente de la tarea. El programa aún puede ser obligatorio.

Establezca ONSLOWNET cuando las tareas 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

Clasificatorios: [Not_null]

Nombre único y descriptivo del anuncio.

AssignedSchedule Tipo de datos: SMS_ScheduleToken matriz

Tipo de acceso: Lectura y escritura

Calificadores: [max(15), lazy]

SMS_ScheduleToken Server WMI Class que indican el momento en que el anuncio se vuelve obligatorio para los clientes.

AssignedScheduleEnabled

Tipo de datos: Boolean

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

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: [perezoso]

true si la programación definida en la AssignedSchedule propiedad está en hora métrica universal (UMT). El valor predeterminado es false.

AssignmentID

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Identificador de la asignación asociada al anuncio.

CollectionID

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: [Not_null]

Colección existente a la que está dirigido el anuncio.

Comment

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Descripción o nota simple sobre el anuncio. El valor predeterminado es "".

DeviceFlags

Tipo de datos: UInt32

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Marcas que describen el dispositivo. Los valores posibles se enumeran a continuación. El valor predeterminado es 0.

ExpirationTime

Tipo de datos: DateTime

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Fecha y hora en que el anuncio ya no está disponible para los clientes. El valor predeterminado es 19900101000000.000000+****.

ExpirationTimeEnabled

Tipo de datos: Boolean

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

true Si el anuncio caduca a la hora indicada por la ExpirationTime propiedad. El valor predeterminado es false.

ExpirationTimeIsGMT

Tipo de datos: Boolean

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

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

Clasificatorios: ninguno

Reservado.

IncludeSubCollection

Tipo de datos: Boolean

Tipo de acceso: Lectura y escritura

Clasificatorios: 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, perezoso]

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 deben modificarse. Cualquier ISV o propietario de una aplicación que use esta propiedad debe incluir un identificador en los datos para que se pueda establecer fácilmente la propiedad.

ISVDataSize

Tipo de datos: UInt32

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

El 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

Clasificatorios: ninguno

Cadena para extensibilidad de asociados.

MandatoryCountdown

Tipo de datos: UInt32

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Duración, en minutos, para mostrar la cuenta atrás obligatoria de la notificación de 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 usuarios.

PackageID

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: [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

Clasificatorios: ninguno

Fecha y hora en que el anuncio se pone a disposición de los clientes. El valor predeterminado es 19900101000000.000000+****.

PresentTimeEnabled

Tipo de datos: Boolean

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

true(predeterminado) si Configuration Manager aplica la hora actual.

PresentTimeIsGMT

Tipo de datos: Boolean

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

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]

La prioridad usada en la replicación del anuncio en sitios secundarios. Los valores posibles se enumeran a continuación. El valor predeterminado es NORMAL (2).

ProgramName

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: [Not_null]

Programa 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 debe ejecutarse el programa cuando el cliente está conectado local o remotamente a un punto de distribución. Los valores posibles se enumeran a continuación. El valor predeterminado es 48.

SourceSite

Tipo de datos: String

Tipo de acceso: solo lectura

Clasificatorios: [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: [read, bits]

Reservado para uso interno. Marcas que duplican la información de las propiedades relacionadas con el tiempo. Los valores posibles se enumeran a continuación. Por ejemplo, ENABLE_PRESENT se establece cuando PresentTimeEnabled es igual a true.

Comentarios

Los calificadores de clase para esta clase incluyen:

• Protegida

  Para obtener más información acerca de los calificadores de clase y de propiedad incluidos en la sección Propiedades, consulte Calificadores de clase y de propiedad de Configuration Manager.

  Aunque no hay otras propiedades de clave, las propiedades AdvertisementName, CollectionID, PackageID, y ProgramName se califican como NOT_NULL, y se deben proporcionar. 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 con los valores correctos.

Requisitos

Requisitos del entorno de ejecución

Para obtener más información, consulta Requisitos de tiempo de ejecución del servidor de Configuration Manager.

Requisitos de desarrollo

Para obtener más información, consulta Requisitos de desarrollo del servidor de Configuration Manager.