Classe WMI SMS_Program Server

La SMS_Program classe Windows Management Instrumentation (WMI) est une classe de serveur fournisseur SMS, dans Configuration Manager, qui représente un programme ou une commande à exécuter lors de la distribution d’un logiciel sur un ordinateur client.

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_Program : SMS_BaseClass
{
     UInt32 ActionInProgress;
     String ApplicationHierarchy;
     String CommandLine;
     String Comment;
     String DependentProgram;
     String Description;
     UInt32 DeviceFlags;
     String DiskSpaceReq;
     String DriveLetter;
     UInt32 Duration;
     UInt8 ExtendedData[];
     UInt32 ExtendedDataSize;
     UInt8 Icon[];
     UInt32 IconSize;
     UInt8 ISVData[];
     UInt32 ISVDataSize;
     String ISVString;
     String MSIFilePath
     String MSIProductID
     String PackageID;
     String PackageName
     UInt32 PackageType
     String PackageVersion
     UInt32 ProgramFlags;
     String ProgramName;
     String RemovalKey;
     String Requirements;
     UInt32 SecuredTypeID
     SMS_OS_Details SupportedOperatingSystems[];
     UInt32   TransformReadiness=0;
     Datetime TransformAnalysisDate;
     String   TransformDtID;
     String WorkingDirectory;
};

Méthodes

La SMS_Program classe ne définit aucune méthode.

Propriétés

ActionInProgress Type de données : UInt32

Type d’accès : Lecture seule

Qualificatifs : [lire, énumération]

Action en cours d’exécution sur le package associé au programme par Configuration Manager. Les valeurs possibles sont les suivantes :

Utilisez cette propriété dans une clause WHERE pour filtrer les programmes qui ont été marqués pour suppression, mais qui n’ont pas encore été supprimés. Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

ApplicationHierarchy Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Hiérarchie des applications pour le programme. La valeur par défaut est «  ».

CommandLine Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Ligne de commande qui s’exécute au démarrage du programme. La valeur par défaut est «  ».

Comment Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Commentaire décrivant le programme dans la console Configuration Manager. La valeur par défaut est «  ».

DependentProgram Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Chaîne de texte mise en forme définissant un programme devant être exécuté avant d’exécuter ce programme. Le format est défini comme suit < : PackageID> ;;<Nom du> programme. Si le programme est dans le même paquet, l’application appelante peut simplement spécifier ;;<Nom du> programme. La valeur par défaut est «  ».

La dépendance est conservée uniquement la première fois que le programme s’exécute. Une fois le programme exécuté, la dépendance est ignorée. Par exemple, vous ne pouvez pas créer une tâche planifiée récurrente pour laquelle la dépendance est maintenue pour chaque exécution du programme.

Description Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Non utilisé.

DeviceFlags Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Indicateurs décrivant l’appareil associé au programme. Les valeurs possibles sont les suivantes :

DiskSpaceReq Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Espace disque approximatif requis par le programme. Le format est "<taille><KB|MB|GB".> La valeur par défaut est «  ».

Ces informations sont utilisées dans la console du Configuration Manager et dans la publication pour fournir des alertes sur l’espace disque requis du programme. L’utilisateur peut alors décider d’accepter l’annonce ou d’effectuer d’abord une tâche de gestion des disques.

DriveLetter Type de données : String

Type d’accès : Lecture/écriture

Qualificateurs : [SizeLimit(« 1 »), Range(« a-z »)]

Lettre de lecteur (un caractère dans la plage a-z) à partir de laquelle le programme est mappé et à partir de là. La valeur par défaut est «  ».

Duration Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Durée approximative, en minutes, de l’exécution du programme sur l’ordinateur client. Spécifiez cette valeur sous la forme d’un nombre entier supérieur ou égal à 0 (par défaut) ou comme inconnu (déconseillé). Si la propriété est définie sur Inconnu, le Configuration Manager définit la durée d’exécution maximale autorisée sur 720 minutes (12 heures). Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

ExtendedData Type de données : UInt8 tableau

Type d’accès : Lecture/écriture

Qualificatifs : [large, paresseux]

Objet blob XML pour le déploiement d’images.

ExtendedDataSize Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

Taille de données étendue, en octets. La valeur par défaut est 0.

Icon Type de données : UInt8 tableau

Type d’accès : Lecture/écriture

Qualificateurs : [large]

Informations sur l’icône du programme associées à l’icône du programme, telles qu’elles sont affichées dans la console du Configuration Manager.

IconSize Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

Taille, en octets, de l’icône du programme. Définissez cette propriété sur 0 pour effacer l’icône.

ISVData Type de données : UInt8 tableau

Type d’accès : Lecture/écriture

Qualificatifs : [large, paresseux]

Des informations qui permettent à un seul éditeur de logiciels indépendant de stocker les données relatives à un SMS_Program objet.

Il n’existe aucune restriction ni format défini pour les données ISV. Cependant, il est important de ne pas écraser la propriété une fois que la propriété de l’ISV a été établie. Votre application 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. Vous devez inclure un identifiant dans les données du programme afin que la propriété puisse être établie facilement.

ISVDataSize Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

Taille, en octets, des données stockées dans ISVData. La valeur par défaut est 0.

ISVString Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : aucun

Chaîne pour l’extensibilité des partenaires.

MSIFilePath Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Chemin d’accès au fichier du package Windows Installer auquel le programme est associé. La valeur par défaut est «  ».

MSIProductID Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

ID de produit du package Windows Installer auquel le programme est associé. La valeur par défaut est «  ».

PackageID Type de données : String

Type d’accès : Lecture/écriture

Qualificateurs : [key, Not_null]

ID d’un package existant auquel associer le programme. Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

PackageName Type de données : String

Type d’accès : Lecture/écriture

Qualificateurs : [Aucun]

Nom du package auquel le programme appartient.

PackageType Type de données : String

Type d’accès : Lecture/écriture

Qualificateurs : [Aucun]

Type du package auquel le programme appartient.

PackageVersion Type de données : String

Type d’accès : Lecture/écriture

Qualificateurs : [Aucun]

Version du package auquel le programme appartient.

ProgramFlags Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificateurs : [bits]

Indicateurs identifiant les caractéristiques d’installation du programme. Les valeurs possibles sont énumérées ci-dessous. Les valeurs par défaut sont EVERYUSER, USEUNCPATH, USERCONTEXT et UNATTENDED.

Les valeurs possibles sont les suivantes :

ProgramName Type de données : String

Type d’accès : Lecture/écriture

Qualificateurs : [key, Not_null]

Nom unique qui représente ce programme.

RemovalKey Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Clé de Registre qui identifie le script de désinstallation pour le programme. Le script doit résider dans le chemin d’accès au HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall Registre. La valeur par défaut est «  ».

Requirements Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Description de toutes les exigences supplémentaires du programme. La valeur par défaut est «  ».

SecuredTypeID Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificateurs : [Aucun]

Type sécurisé de colis associé.

SupportedOperatingSystems Type de données : SMS_OS_Details tableau

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

SMS_OS_Details Objets de classe WMI Server représentant les systèmes d’exploitation sur lesquels le programme peut s’exécuter.

Si vous ne spécifiez ANY_PLATFORM dans la ProgramFlags propriété, vous devez spécifier un ou plusieurs systèmes d’exploitation pris en charge. SMS_SupportedPlatforms classe WMI Server définit la liste des plates-formes que Configuration Manager prend en charge.

TransformAnalysisDate Type de données : DateTime

Type d’accès : Lecture/écriture

Qualificateurs : [Aucun]

À usage interne uniquement.

TransformDtID Type de données : String

Type d’accès : Lecture/écriture

Qualificateurs : [Aucun]

À usage interne uniquement.

TransformReadiness Type de données : UInt32

Type d’accès : Lecture/écriture

Qualificateurs : [Aucun]

À usage interne uniquement.

WorkingDirectory Type de données : String

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Emplacement à partir duquel le programme s’exécute. La valeur par défaut est «  ».

Le répertoire de travail peut être un chemin d’accès absolu sur le client ou un chemin d’accès relatif au dossier du point de distribution qui contient le package. Si aucun répertoire de travail n’est spécifié, Configuration Manager utilise le dossier de point de distribution par défaut.

Remarques

Il n’y a pas de qualifications spéciales pour cette classe. 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.

Un programme est toujours associé à un package parent et représente généralement le programme d’installation du package. Plusieurs programmes peuvent être associés au même package. L’application utilise la PackageID propriété pour faire cette association. Votre application ne peut pas modifier cette propriété après la création de l’objet SMS_Program . Pour associer le programme à un autre package, l’application doit supprimer l’objet et créer un objet avec une nouvelle PackageID valeur.

Lorsque votre application supprime un SMS_Program objet, elle n’est pas supprimée tant que ses composants associés, tels que ses publicités, ne sont pas supprimés. Au lieu de cela, Configuration Manager définit la ActionInProgress propriété sur DELETE (3) pour marquer le programme pour suppression. Pour vous assurer qu’une requête ne récupère pas les programmes marqués pour suppression, ajoutez ce cas à la clause WHERE.

Il est recommandé de ne pas définir la Duration propriété sur Inconnu, car cette propriété est utilisée à deux fins importantes suivantes :

• Surveiller les résultats du programme.

• Pour déterminer si le programme sera lancé lorsque des fenêtres de maintenance auront été définies sur les ordinateurs clients.

  Si votre application définit la propriété mais que la Duration durée d’exécution du programme dépasse cette durée, le Gestionnaire de Configuration Manager cesse de surveiller le programme, mais ne le met pas fin. Cela permet à Configuration Manager de continuer avec d’autres fonctions de distribution de logiciels, telles que l’exécution d’autres programmes publiés. Le gestionnaire ne :

• Arrêter le programme.

• Libérez tous les lecteurs qui ont été mappés pour le programme annoncé.

• Libérez toutes les connexions réseau établies pour le programme annoncé.

• Ressources de système d’exploitation gratuites utilisées par Configuration Manager lors de l’exécution de programmes publiés.

  Pour plus d’informations, reportez-vous à À propos des fenêtres de maintenance.

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.

Voir aussi

Classe WMI SMS_Package ServerProcédure pour créer un packageProcédure pour créer un programme