SMS_Advertisement classe WMI du serveur
La SMS_Advertisement classe WMI (Windows Management Instrumentation) est une classe de serveur du fournisseur SMS, dans Configuration Manager, qui représente une publication utilisée pour annoncer les programmes de package logiciel disponibles pour s’exécuter 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 .
| Méthode | Description |
|---|---|
| Méthode GetAdvertisements dans la classe SMS_Advertisement | Obtient les ID de publication qui sont ciblés sur la ressource. |
| Méthode GetNextID dans le SMS_Advertisement de classe | Récupère le numéro d’identification qui sera utilisé pour la prochaine publication créée. |
| Méthode RiskyDeploymentStatusMessage dans la classe SMS_Advertisement | Envoie un message d’état d’avertissement concernant un déploiement utilisateur à un regroupement à risque. |
| Méthode SetNextID dans le SMS_Advertisement de classe | Définit le numéro d’identification qui sera utilisé pour la prochaine publication créée. |
| Méthode SetSourceSite dans la classe SMS_Advertisement | Définit le code du site source pour la publication. |
| Méthode Unlock dans le SMS_Advertisement de la classe | Définit le site source sur le site actuel, ce qui déverrouille la publicité. Avertissement: Cette méthode est déconseillée. |
Propriétés
ActionInProgress
Type de donnéesUInt32
Type d’accès : en lecture seule
Qualificateurs : [read, énumération]
Action en cours d’exécution sur le package par Configuration Manager. Les valeurs possibles sont les suivantes :
| Valeur | Description |
|---|---|
| 0 | AUCUN |
| 1 | METTRE À JOUR |
| 2 | Ajouter |
AdvertFlags
Type de donnéesUInt32
Type d’accès : Lecture/écriture
Qualificateurs : [bits]
Indicateurs indiquant comment la publication doit être annoncée à l’utilisateur. Les valeurs possibles sont répertoriées ci-dessous. La valeur par défaut est 0.
| Hexadécimal (bit) | Description |
|---|---|
| 0x00000020 (5) | IMMÉDIATE. Annoncez immédiatement la publication à l’utilisateur. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Annoncez la publication à l’utilisateur au démarrage du système. |
| 0x00000200 (9) | ONUSERLOGON. Annoncez la publicité à l’utilisateur lors de l’ouverture de session. |
| 0x00000400 (10) | ONUSERLOGOFF. Annoncez la publication à l’utilisateur lors de la fermeture de session. |
| 0x00001000 (12) | FACULTATIFPREDOWNLOAD. Si l’architecture et la langue sélectionnées correspondent à celles du client, le contenu du package est téléchargé à l’avance |
| 0x00008000 (15) | WINDOWS_CE. La publication concerne un client d’appareil. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Ces informations s’appliquent à System Center 2012 Configuration Manager SP1 ou version ultérieure, et à System Center 2012 R2 Configuration Manager ou version ultérieure. |
| 0x00020000 (17) | DONOT_FALLBACK. Ne revenez pas aux points de distribution non protégés. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. La séquence de tâches est disponible pour le média amovible et le point de service PXE (Pre-Boot Execution Environment). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Remplacez les fenêtres de maintenance pour annoncer la publication à l’utilisateur. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Redémarrez en dehors des fenêtres de maintenance. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Annoncez la publication à l’utilisateur avec Wake On LAN activé. |
| 0x00800000 (23) | SHOW_PROGRESS. Annoncez la publication à l’utilisateur montrant la progression de la séquence de tâches. |
| 0x02000000 (25) | NO_DISPLAY. L’utilisateur ne doit pas exécuter de programmes indépendamment de l’affectation. |
| 0x04000000 (26) | ONSLOWNET. Les affectations sont obligatoires sur une connexion réseau lente. |
| 0x10000000 (28) | TARGETTOWINPE. Ciblez ce déploiement sur WinPE uniquement. |
| 0x20000000 (29) | HIDDENINWINPE. Ciblez ce déploiement uniquement sur WinPE, mais masquez-le dans WinPE. Il ne peut être utilisé que par la variable TS SMSTSPreferredAdvertID. |
Ces indicateurs doivent être coordonnés avec les indicateurs spécifiés dans la ProgramFlags propriété du programme publié. Par exemple, si vous définissez ONUSERLOGOFF, l’indicateur NOUSERLOGGEDIN dans le programme doit être défini. Si les paramètres de l’indicateur ne correspondent pas, le programme n’est pas publié. Pour plus d’informations, consultez classe WMI du serveur SMS_Program.
La définition de IMMEDIATE, ONUSERLOGON ou ONUSERLOGOFF ou la fourniture d’une AssignedSchedule valeur rend le programme publié obligatoire. Un programme obligatoire est exécuté automatiquement une fois 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 lorsque vous ne souhaitez pas que l’utilisateur exécute des programmes indépendamment de l’affectation. Si vous ne définissez pas cet indicateur, la publication est affichée 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 affectations 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é générée automatiquement unique qui identifie la publication. La valeur par défaut est « ».
AdvertisementName
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : [Not_null]
Nom convivial unique pour la publication.
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 l’heure à laquelle la publication devient obligatoire sur les clients.
AssignedScheduleEnabled
Type de donnéesBoolean
Type d’accès : Lecture/écriture
Qualificateurs : [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
Qualificateurs : [paresseux]
true si la planification définie dans la AssignedSchedule propriété est en temps de métrique universel (UMT). La valeur par défaut est false.
AssignmentID
Type de donnéesUInt32
Type d’accès : en lecture seule
Qualificateurs : [read]
ID de l’affectation associée à la publication.
CollectionID
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : [Not_null]
Collection existante vers laquelle la publicité est ciblée.
Comment
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : Aucun
Description simple ou note sur la publicité. La valeur par défaut est « ».
DeviceFlags
Type de donnéesUInt32
Type d’accès : Lecture/écriture
Qualificateurs : Aucun
Indicateurs décrivant l’appareil. Les valeurs possibles sont répertoriées ci-dessous. La valeur par défaut est 0.
| Hexadécimal (bit) | Description |
|---|---|
| 0x01000000 (24) | Affectez toujours le programme au client. |
| 0x02000000 (25) | Affectez uniquement si l’appareil est actuellement connecté à une connexion à bande passante élevée (par défaut au-dessus de 60 Kbits/s). |
| 0x04000000 (26) | Attribuez uniquement si l’appareil est ancré, c’est-à-dire qu’il est attaché à un bureau qui utilise ActiveSync. |
ExpirationTime
Type de donnéesDateTime
Type d’accès : Lecture/écriture
Qualificateurs : 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
Qualificateurs : [paresseux]
true si la publication 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
Qualificateurs : [paresseux]
true si l’heure définie dans la ExpirationTime propriété est en UMT. La valeur par défaut est false.
HierarchyPath
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : Aucun
Réservé.
IncludeSubCollection
Type de donnéesBoolean
Type d’accès : Lecture/écriture
Qualificateurs : Aucun
true (valeur par défaut) si la publication est annoncée dans les sous-collections de la collection spécifiée.
ISVData
Type de données : Uint8 Tableau
Type d’accès : Lecture/écriture
Qualificateurs : [large, paresseux]
Informations qui permettent à un éditeur de logiciels indépendant de stocker des données relatives à une SMS_Program instance. Il n’existe aucune restriction ou format défini pour ces données. Toutefois, il est important de ne pas remplacer 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
Qualificateurs : [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
Qualificateurs : aucun
Chaîne pour l’extensibilité du partenaire.
MandatoryCountdown
Type de donnéesUInt32
Type d’accès : Lecture/écriture
Qualificateurs : Aucun
Durée, en minutes, pour afficher le compte à rebours obligatoire de la planification du déploiement du système d’exploitation. La valeur par défaut est 0.
OfferType
Type de donnéesUInt32
Type d’accès : Lecture/écriture
Qualificateurs : [énumération]
Type de publication qui indique que la publication est destinée aux utilisateurs.
| Valeur | Description |
|---|---|
| 0 | Requis |
| 2 | Disponible |
PackageID
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : [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
Qualificateurs : Aucun
Date et heure auxquelles la publicité 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
Qualificateurs : [paresseux]
true(valeur par défaut) si l’heure actuelle est appliquée par Configuration Manager.
PresentTimeIsGMT
Type de donnéesBoolean
Type d’accès : Lecture/écriture
Qualificateurs : [paresseux]
true si l’heure définie dans la PresentTime propriété est en UMT. La valeur par défaut est false.
Priority
Type de donnéesUInt32
Type d’accès : Lecture/écriture
Qualificateurs : [énumération]
Priorité utilisée dans la réplication de la publication sur les sites enfants. Les valeurs possibles sont répertoriées ci-dessous. La valeur par défaut est NORMAL (2).
| Valeur | Description |
|---|---|
| 1 | HAUTE |
| 2 | NORMAL |
| 3 | Faible |
ProgramName
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : [Not_null]
Programme dans le package spécifié (PackageID) à publier.
RemoteClientFlags
Type de donnéesUInt32
Type d’accès : Lecture/écriture
Qualificateurs : [bits]
Indicateurs spécifiant la façon dont le programme doit s’exécuter lorsque le client est connecté localement ou à distance à un point de distribution. Les valeurs possibles sont répertoriées ci-dessous. La valeur par défaut est 48.
| Hexadécimal (bit) | Description |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Exécutez le programme à l’aide de la batterie. Cette valeur est actuellement inutilisée. |
| 0x00000002 (1) | RUN_FROM_CD. Exécutez le programme à partir du CD. Cette valeur est actuellement inutilisée. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Téléchargez le programme à partir du CD. Cette valeur est actuellement inutilisée. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Exécutez le programme à partir du point de distribution local. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Téléchargez le programme à partir du point de distribution local. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. N’exécutez pas le programme s’il n’existe aucun point de distribution local. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Téléchargez le programme à partir du point de distribution distant. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Exécutez le programme à partir du point de distribution distant. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Téléchargez le programme à la demande à partir du point de distribution local. Cela s’applique uniquement aux séquences de tâches. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Téléchargez le programme à la demande à partir du point de distribution distant. Cela s’applique uniquement aux séquences de tâches. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. Des rappels de bulles sont requis. |
| 0x00000800 (11) | RERUN_ALWAYS. Réexécutez toujours le programme. |
| 0x00001000 (12) | RERUN_NEVER. Ne réexécutez jamais le programme. |
| 0x00002000 (13) | RERUN_IF_FAILED. Réexécutez le programme si l’exécution a échoué précédemment. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Réexécutez le programme si l’exécution a réussi précédemment. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Ces informations s’appliquent à System Center 2012 Configuration Manager SP1 ou version ultérieure, et à System Center 2012 R2 Configuration Manager ou version ultérieure. |
| 0x00020000 (17) | DON’T_FALLBACK Ces informations s’appliquent à System Center 2012 Configuration Manager SP1 ou version ultérieure, et à System Center 2012 R2 Configuration Manager ou version ultérieure. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Ces informations s’appliquent à System Center 2012 Configuration Manager SP1 ou version ultérieure, et à System Center 2012 R2 Configuration Manager ou version ultérieure. |
SourceSite
Type de donnéesString
Type d’accès : en lecture seule
Qualificateurs : [read]
Code de site à trois lettres du site d’où provient la publicité.
TimeFlags
Type de donnéesUInt32
Type d’accès : en lecture seule
Qualificateurs : [read, bits]
Réservé à une utilisation interne. Indicateurs qui dupliquent les informations dans les propriétés temporelles. Les valeurs possibles sont répertoriées ci-dessous. Par exemple, ENABLE_PRESENT est défini quand PresentTimeEnabled est égal à true.
| Hexadécimal (bit) | Description |
|---|---|
| 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 |
Remarques
Les qualificateurs de classe pour cette classe sont les suivants :
Sécurisé
Pour plus d’informations sur les qualificateurs de classe et les qualificateurs de propriété inclus dans la section Propriétés, consultez Configuration Manager Qualificateurs de classe et de propriété.
Bien qu’il n’existe aucune autre propriété de clé, les propriétés
AdvertisementName,CollectionID,PackageIDetProgramNamesont 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
Conditions requises pour le runtime
Pour plus d’informations, consultez Configuration Manager Server Runtime Requirements.
Exigences de développement
Pour plus d’informations, consultez Configuration Manager Server Development Requirements.