CCM_SoftwareUpdate klientens WMI-klass

CCM_SoftwareUpdate WMI-klassen är en klientklass i Configuration Manager som representerar en programuppdatering.

Om du räknar upp den här klassen får du alla uppdateringar som är tillämpliga och som måste installeras. Du kan använda GetObject för att fråga efter en enskild uppdatering baserat på UpdateID egenskapen . Varje uppdateringsobjekt har egenskaper som motsvarar det gamla COM-gränssnittet ICCMTargetedUpdate. Mer information om enskilda egenskaper finns i gränssnittet Configuration Manager 2007 ICCMTargetedUpdate. Här har vi bara listat skillnaderna mellan ICCMTargetedUpdate klasser och CCM_SoftwareUpdate .

Viktigt

SDK:et för programuppdateringsklienten returnerar endast en uppsättning uppdateringar som distribueras till klienten från Configuration Manager platsserver och som är tillämpliga och som ännu inte har installerats på klienten.

Följande syntax förenklas från MOF-koden (Managed Object Format) och innehåller alla ärvda egenskaper.

Syntax

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;  
};  

Metoder

Klassen CCM_SoftwareUpdate definierar inga metoder.

Egenskaper

ArticleID
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Identifierare för kunskapsbas artikel för programuppdateringen. Maxlängden för det här värdet är 64 tecken.

BulletinID
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Identifierare för bulletinen för säkerhetsuppdateringar som släppts av Microsoft. Maxlängden för det här värdet är 64 tecken. Standardvärdet är None.

ComplianceState
Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Kompatibilitetstillstånd för programuppdateringen som anger om programuppdateringen saknas och måste installeras. Tillståndet ciNotPresent anger saknade uppdateringar. I följande tabell visas andra möjliga värden för egenskapen ComplianceState för programuppdateringar. Endast värdena 0, 1 och 2 används av programuppdateringshantering.

Värde	Tillstånd
0	ciNotPresent
1	ciPresent
2	ciPresenceUnknown (används även för ej tillämpligt)
3	ciEvaluationError
4	ciNotEvaluated
5	ciNotUpdated
6	ciNotConfigured

ContentSize
Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Storleken på programuppdateringsinnehållet.

Obs!

Den här egenskapen är endast tillgänglig när programuppdateringen har laddats ned till Configuration Manager cacheminnet, inte tidigare.

Deadline
Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Datum och tid då programuppdateringen installeras.

Description
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Beskrivning av programuppdateringen.

ErrorCode
Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Eventuell felkod som är associerad med programuppdateringen.

EvaluationState
Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Utvärderingstillstånd för programuppdateringen. När metoden InstallUpdates i CCM_SoftwareUpdatesManager klassen anropas för att utlösa installation av programuppdateringar kan egenskaperna EvaluationState, PercentComplete och ErrorCode användas för att övervaka uppdateringsförloppet.

Obs!

Egenskapen EvaluationState är bara avsedd att utvärdera förloppet, inte för att hitta kompatibilitetstillståndet för en programuppdatering. När en programuppdatering inte är i ett förloppstillstånd är none värdet för EvaluationState eller available, beroende på om det fanns några förlopp vid någon tidpunkt tidigare. Detta är inte relaterat till kompatibilitetstillstånd. Om en programuppdatering laddades ned vid aktiveringstillfället är nonevärdet för EvaluationState också . Det här värdet ändras bara när ett installationsförsök görs på programuppdateringen.

I följande tabell visas värdena för egenskapen EvaluationState för programuppdateringar.

Värde	Tillstånd
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
Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

trueom programuppdateringen är EXKLUSIV; annars . false Det går inte att installera en exklusiv uppdatering samtidigt som andra uppdateringar.

FullName
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Den här egenskapen används inte.

IsUpgrade
Datatyp: Boolean

Åtkomsttyp: Läsa/skriva

Kvalificerare: ingen

Anger om programuppdateringen är en uppgradering.

MaxExecutionTime
Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Maximal tid som krävs för att programuppdateringen ska köras.

Name
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Namnet på programuppdateringen.

NextUserScheduledTime
Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Datum och tid när en användare skjuter upp specifika programuppdateringar till icke-kontorstid (NBH). Den här egenskapen visar nästa NBH som ska användas.

NotifyUser
Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

trueom meddelanden för programuppdateringen visas för användaren; annars . false

Obs!

Om UserUIExperience är inställt på falseNotifyUser ignoreras .

OverrideServiceWindows
Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

trueom programuppdateringen kan installeras utanför underhållsperioderna; annars . false

PercentComplete
Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Procentandel av slutförandet av installationen av programuppdateringen.

Publisher
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Utgivare av programuppdateringen.

RebootOutsideServiceWindows
Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

trueom programuppdateringen kan startas om utanför underhållsperioder; annars . false

RestartDeadline
Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Datum och tid då en dator startas om efter installationen av programuppdateringen.

StartTime
Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Datum och tid då programuppdateringen görs tillgänglig för användaren.

UpdateID
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Identifierare för programuppdateringen.

URL
Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

URL för en programuppdatering.

UserUIExperience
Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

trueom programuppdateringen visas i Software Center; annars . false

Krav

Körningskrav

Mer information finns i Configuration Manager Krav för klientkörning.

Utvecklingskrav

Mer information finns i Configuration Manager Krav för klientutveckling.