SMS_Advertisement classe WMI du serveur

La SMS_Advertisement classe Windows Management Instrumentation (WMI) est une classe de serveur de fournisseur SMS, dans Configuration Manager, qui représente une publication utilisée pour annoncer des programmes de package logiciel disponibles pour exécution sur les clients.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et inclut toutes les propriétés héritées.

Syntaxe

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éthodes

Le tableau suivant répertorie les méthodes de la SMS_Advertisement classe.

Propriétés

ActionInProgress

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [lire, énumération]

Action en cours exécutée sur le package par le Configuration Manager. Les valeurs possibles sont les suivantes :

AdvertFlags

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificateurs : [bits]

Indicateurs indiquant comment la publicité doit être annoncée à l’utilisateur. Les valeurs possibles sont énumérées ci-dessous. La valeur par défaut est 0.

Ces indicateurs doivent être coordonnés avec les indicateurs spécifiés dans la ProgramFlags propriété du programme annoncé. Par exemple, si vous définissez ONUSERLOGOFF, l’indicateur NOUSERLOGGEDIN doit être défini dans le programme. Si les paramètres de l’indicateur ne correspondent pas, le programme n’est pas publié. Pour plus d’informations, consultez SMS_Program classe WMI du serveur.

La définition de IMMEDIATE, ONUSERLOGON ou ONUSERLOGOFF ou la fourniture d’une AssignedSchedule valeur rend obligatoire le programme publié. Un programme obligatoire est exécuté automatiquement après que le client a reçu la publication. Le client ne peut pas rejeter ou reporter l’installation.

Définissez les bits NO_DISPLAY et ONSLOWNET uniquement lorsque le bit IMMEDIATE, ONUSERLOGON ou ONUSERLOGOFF est défini ou que le programme a une AssignedSchedule valeur.

Définissez NO_DISPLAY si vous ne souhaitez pas que l’utilisateur exécute des programmes indépendamment de l’affectation. Si vous ne configurez pas cet indicateur, l’annonce s’affiche dans la liste des annonces et peut être exécutée indépendamment de l’affectation. Le programme peut toujours être obligatoire.

Définissez ONSLOWNET lorsque les assignations sont obligatoires sur une connexion réseau lente, par exemple lorsqu’un ordinateur se connecte à l’aide d’un modem.

AdvertisementID

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [key, ResID(801), ResDLL(« SMS_RSTT.dll »)]

Clé unique générée automatiquement qui identifie la publication. La valeur par défaut est «  ».

AdvertisementName

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : [Not_null]

Nom convivial unique pour l’annonce.

AssignedSchedule Type de données : SMS_ScheduleToken tableau

Type d’accès : Lecture/écriture

Qualificateurs : [max(15), paresseux]

SMS_ScheduleToken Objets de classe WMI Server indiquant le moment où la publication devient obligatoire sur les clients.

AssignedScheduleEnabled

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

true si la planification définie dans la AssignedSchedule propriété est active. La valeur par défaut est false.

AssignedScheduleIsGMT

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

true si la planification définie dans la AssignedSchedule propriété est en temps métrique universel (UMT). La valeur par défaut est false.

AssignmentID

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [lire]

ID de l’affectation associée à l’annonce.

CollectionID

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : [Not_null]

Collection existante à laquelle la publicité est destinée.

Comment

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Description simple ou note relative à l’annonce. La valeur par défaut est «  ».

DeviceFlags

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Indicateurs décrivant l’appareil. Les valeurs possibles sont énumérées ci-dessous. La valeur par défaut est 0.

ExpirationTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Date et heure auxquelles la publication n’est plus disponible pour les clients. La valeur par défaut est 19900101000000.000000+****.

ExpirationTimeEnabled

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

true Si l’annonce expire à l’heure indiquée par la ExpirationTime propriété. La valeur par défaut est false.

ExpirationTimeIsGMT

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

true si l’heure définie dans la ExpirationTime propriété est dans UMT. La valeur par défaut est false.

HierarchyPath

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Réservé.

IncludeSubCollection

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

true (par défaut) si la publication est publiée pour les sous-collections de la collection spécifiée.

ISVData

Type de données : Uint8 tableau

Type d’accès : Lecture/écriture

Qualificatifs : [large, paresseux]

Informations qui permettent à un seul éditeur de logiciels indépendant de stocker les données relatives à une SMS_Program instance. Il n’existe aucune restriction ni aucun format défini pour ces données. Cependant, il est important de ne pas écraser la propriété une fois que sa propriété ISV a été établie. Par conséquent, l’application appelante doit d’abord lire les données existantes dans cette propriété. Si les données n’appartiennent pas à l’application, elles ne doivent pas être modifiées. Tout éditeur de logiciels indépendant ou propriétaire d’application qui utilise cette propriété doit inclure un identificateur dans les données afin que la propriété puisse être facilement établie.

ISVDataSize

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

Taille des données représentées par la ISVData propriété. La valeur par défaut est 0.

ISVString

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : aucun

Chaîne pour l’extensibilité des partenaires.

MandatoryCountdown

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Durée, en minutes, pour afficher la notification de l’utilisateur de déploiement de système d’exploitation compte à rebours de la planification obligatoire. La valeur par défaut est 0.

OfferType

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : [énumération]

Type de publication qui indique que la publicité est destinée aux utilisateurs.

PackageID

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : [Not_null]

ID d’un package existant associé à la publication. La valeur doit être en majuscules.

PresentTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Date et heure auxquelles la publication est mise à la disposition des clients. La valeur par défaut est 19900101000000.000000+****.

PresentTimeEnabled

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

true(par défaut) si l’heure actuelle est appliquée par Configuration Manager.

PresentTimeIsGMT

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

true si l’heure définie dans la PresentTime propriété est dans UMT. La valeur par défaut est false.

Priority

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : [énumération]

Priorité utilisée pour répliquer la publicité sur les sites enfants. Les valeurs possibles sont énumérées ci-dessous. La valeur par défaut est NORMAL (2).

ProgramName

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : [Not_null]

Un programme du package spécifié (PackageID) à faire l’objet d’une publicité.

RemoteClientFlags

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificateurs : [bits]

Indicateurs spécifiant le mode d’exécution du programme lorsque le client est connecté localement ou à distance à un point de distribution. Les valeurs possibles sont énumérées ci-dessous. La valeur par défaut est 48.

SourceSite

Type de donnéesString

Type d’accès : Lecture seule

Qualificatifs : [lire]

Code de site à trois lettres du site d’où provient la publicité.

TimeFlags

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [lire, bits]

Réservé à une utilisation interne. Indicateurs qui dupliquent les informations dans les propriétés liées au temps. Les valeurs possibles sont énumérées ci-dessous. Par exemple, ENABLE_PRESENT est défini lorsque PresentTimeEnabled la valeur est égale à true.

Remarques

Les qualificatifs de classe pour cette classe sont les suivants :

• Sécurisé

  Pour plus d’informations sur les qualificateurs de classe et de propriété inclus dans la section Propriétés, voir Qualificateurs de classe et de propriété du Configuration Manager.

  Bien qu’il n’existe aucune autre propriété de clé, les propriétés AdvertisementName, CollectionID, PackageIDet ProgramName sont qualifiées de NOT_NULL, et les valeurs doivent être fournies. Votre application ne peut pas mettre à jour ces propriétés après la création d’une instance de classe. Pour modifier ces valeurs, l’application doit supprimer l’instance et créer une nouvelle instance avec les valeurs correctes.

Configuration requise

Configuration requise pour l’exécution

Pour plus d’informations, consultez Configuration requise pour Configuration Manager Server Runtime.

Configuration requise pour le développement

Pour plus d’informations, consultez Configuration requise pour le développement du serveur Configuration Manager.