Classe WMI du client CCM_SoftwareUpdate

La CCM_SoftwareUpdate classe WMI est une classe de client, dans Configuration Manager, qui représente une mise à jour logicielle.

L’énumération de cette classe fournit toutes les mises à jour applicables et qui doivent être installées. Vous pouvez utiliser GetObject pour rechercher une mise à jour individuelle en fonction de la UpdateID propriété. Chaque objet de mise à jour a des propriétés équivalant à l’ancienne interface COM ICCMTargetedUpdate . Pour plus d’informations sur les propriétés individuelles, vous pouvez vous référer à Configuration Manager interface ICCMTargetedUpdate 2007. Nous avons répertorié ici uniquement les différences entre ICCMTargetedUpdate les CCM_SoftwareUpdate classes et.

Important

Le kit de développement logiciel (SDK) côté client des mises à jour logicielles retourne uniquement les ensembles de mises à jour qui sont déployés sur le client à partir de Configuration Manager serveur de site et qui sont applicables, et qui ne sont pas encore installés sur le client.

La syntaxe suivante est simplifiée du code format MOF (MOF) et comprend toutes les propriétés héritées.

Syntaxe

class CCM_SoftwareUpdate : CCM_SoftwareBase  
{  
     String ArticleID;  
     String BulletinID;  
     UInt32 ComplianceState;  
     UInt32 ContentSize;  
     Datetime Deadline  
     String Description;  
     UInt32 ErrorCode;  
     UInt32 EvaluationState;  
     Boolean ExclusiveUpdate;  
     String FullName;  
     Boolean IsUpgrade;  
     UInt32 MaxExecutionTime;  
     String Name;  
     Datetime NextUserScheduledTime;  
     Boolean NotifyUser;  
     Boolean OverrideServiceWindows;  
     UInt32 PercentComplete;  
     String Publisher;  
     Boolean RebootOutsideServiceWindows;  
     Datetime RestartDeadline;  
     Datetime StartTime;  
     String UpdateID;  
     String URL;  
     Boolean UserUIExperience;  
};  

Méthodes

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

Propriétés

ArticleID
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Identificateur de l’article de la base de connaissances pour la mise à jour logicielle. La longueur maximale de cette valeur est de 64 caractères.

BulletinID
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Identificateur du bulletin pour les mises à jour de sécurité publiées par Microsoft. La longueur maximale de cette valeur est de 64 caractères. La valeur par défaut est None.

ComplianceState
Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : [lecture]

État de conformité de la mise à jour logicielle qui indique si la mise à jour logicielle est manquante et doit être installée. L' ciNotPresent État indique des mises à jour manquantes. Le tableau suivant présente d’autres valeurs possibles pour la propriété ComplianceState pour les mises à jour logicielles. Seules les valeurs 0, 1 et 2 sont utilisées par la gestion des mises à jour logicielles.

Valeur State
0 ciNotPresent
1 ciPresent
2 ciPresenceUnknown (également utilisé pour non applicable)
3 ciEvaluationError
4 ciNotEvaluated
5 ciNotUpdated
6 ciNotConfigured

ContentSize
Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Taille du contenu des mises à jour logicielles.

Notes

Cette propriété n’est disponible qu’une fois que la mise à jour logicielle est téléchargée dans Configuration Manager cache, et non avant.

Deadline
Type de données : Datetime

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Date et heure d’installation de la mise à jour logicielle.

Description
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Description de la mise à jour logicielle.

ErrorCode
Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Code d’erreur, le cas échéant, associé à la mise à jour logicielle.

EvaluationState
Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : [lecture]

État d’évaluation de la mise à jour logicielle. Une fois que la méthode InstallUpdates de la CCM_SoftwareUpdatesManager classe est appelée pour déclencher l’installation des mises à jour logicielles, les propriétés EvaluationState, PercentComplete et ErrorCode peuvent être utilisées pour surveiller la progression des mises à jour.

Notes

La propriété EvaluationState est conçue uniquement pour évaluer la progression, et non pour déterminer l’état de compatibilité d’une mise à jour logicielle. Quand une mise à jour logicielle n’est pas dans un état de progression, la valeur de EvaluationState est none ou available , selon qu’il y avait une progression à un moment quelconque dans le passé. Cela n’est pas lié à l’état de conformité. En outre, si une mise à jour logicielle a été téléchargée au moment de l’activation, la valeur de EvaluationState est none . Cette valeur change uniquement une fois qu’une installation est tentée sur la mise à jour logicielle.

Le tableau suivant montre les valeurs de la propriété EvaluationState pour les mises à jour logicielles.

Valeur State
0 ciJobStateNone
1 ciJobStateAvailable
2 ciJobStateSubmitted
3 ciJobStateDetecting
4 ciJobStatePreDownload
5 ciJobStateDownloading
6 ciJobStateWaitInstall
7 ciJobStateInstalling
8 ciJobStatePendingSoftReboot
9 ciJobStatePendingHardReboot
10 ciJobStateWaitReboot
11 ciJobStateVerifying
12 ciJobStateInstallComplete
13 ciJobStateError
14 ciJobStateWaitServiceWindow
15 ciJobStateWaitUserLogon
16 ciJobStateWaitUserLogoff
17 ciJobStateWaitJobUserLogon
18 ciJobStateWaitUserReconnect
19 ciJobStatePendingUserLogoff
20 ciJobStatePendingUpdate
21 ciJobStateWaitingRetry
22 ciJobStateWaitPresModeOff
23 ciJobStateWaitForOrchestration

ExclusiveUpdate
Type de données : Boolean

Type d'accès : Lecture seule

Qualificateurs : [lecture]

true Si la mise à jour logicielle est EXCLUSIVE ; Sinon, false . Une mise à jour exclusive ne peut pas être installée en même temps que d’autres mises à jour.

FullName
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Cette propriété n'est pas utilisée.

IsUpgrade
Type de données : Boolean

Type d'accès : lecture/écriture

Qualificateurs : aucun

Indique si la mise à jour logicielle est une mise à niveau.

MaxExecutionTime
Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Durée maximale nécessaire à l’exécution de la mise à jour logicielle.

Name
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Nom de la mise à jour logicielle.

NextUserScheduledTime
Type de données : Datetime

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Date et heure auxquelles un utilisateur reporte des mises à jour logicielles spécifiques en dehors des heures de bureau (NBH). Cette propriété affiche le prochain NBH à utiliser.

NotifyUser
Type de données : Boolean

Type d'accès : Lecture seule

Qualificateurs : [lecture]

true Si les notifications pour la mise à jour logicielle sont présentées à l’utilisateur ; Sinon, false .

Notes

Si UserUIExperience a la valeur false , NotifyUser est ignoré.

OverrideServiceWindows
Type de données : Boolean

Type d'accès : Lecture seule

Qualificateurs : [lecture]

true Si la mise à jour logicielle peut être installée en dehors des fenêtres de maintenance ; Sinon, false .

PercentComplete
Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Pourcentage de la fin de l’installation de la mise à jour logicielle.

Publisher
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Éditeur de la mise à jour logicielle.

RebootOutsideServiceWindows
Type de données : Boolean

Type d'accès : Lecture seule

Qualificateurs : [lecture]

true Si la mise à jour logicielle peut redémarrer en dehors des fenêtres de maintenance ; Sinon, false .

RestartDeadline
Type de données : Datetime

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Date et heure auxquelles un ordinateur est redémarré après l’installation de la mise à jour logicielle.

StartTime
Type de données : Datetime

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Date et heure auxquelles la mise à jour logicielle est mise à la disposition de l’utilisateur.

UpdateID
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

Identificateur de la mise à jour logicielle.

URL
Type de données : String

Type d'accès : Lecture seule

Qualificateurs : [lecture]

URL d’une mise à jour logicielle.

UserUIExperience
Type de données : Boolean

Type d'accès : Lecture seule

Qualificateurs : [lecture]

true Si la mise à jour logicielle est visible dans le centre logiciel ; Sinon, false .

Spécifications

Configuration requise du runtime

Pour plus d’informations, consultez Configuration Manager exigences du runtime du client.

Spécifications pour le développement

Pour plus d’informations, consultez Configuration requise pour le développement de clients Configuration Manager.