CCM_SoftwareUpdate, klasa WMI klienta

CCM_SoftwareUpdateKlasa WMI jest klasą klienta w Configuration Manager, która reprezentuje aktualizację oprogramowania.

Wyliczenie tej klasy zapewnia wszystkie aktualizacje, które mają zastosowanie i muszą zostać zainstalowane. Za pomocą GetObject programu można wykonywać zapytania dotyczące pojedynczej aktualizacji na podstawie UpdateID właściwości. Każdy obiekt aktualizacji ma właściwości równoważne z starym interfejsem COM ICCMTargetedUpdate . Aby uzyskać więcej informacji na temat poszczególnych właściwości, można odwoływać się do Configuration Manager 2007 ICCMTargetedUpdate interfejsu. W tym miejscu opisano tylko różnice między ICCMTargetedUpdate CCM_SoftwareUpdate klasami i.

Ważne

Zestaw SDK po stronie klienta aktualizacji oprogramowania zwróci tylko zestaw aktualizacji, które są wdrożone na klientach z Configuration Manager serwera lokacji i mają zastosowanie i nie są jeszcze zainstalowane na kliencie.

Następująca składnia jest uproszczona w kodzie Managed Object Format (MOF) i zawiera wszystkie odziedziczone właściwości.

Składnia

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

Metody

CCM_SoftwareUpdateKlasa nie definiuje żadnych metod.

Właściwości

ArticleID
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Identyfikator artykułu bazy wiedzy dotyczącego aktualizacji oprogramowania. Maksymalna długość tej wartości to 64 znaków.

BulletinID
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Identyfikator biuletynu dla aktualizacji zabezpieczeń wydanych przez firmę Microsoft. Maksymalna długość tej wartości to 64 znaków. Wartość domyślna to None.

ComplianceState
Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Stan zgodności aktualizacji oprogramowania, która wskazuje, czy brakuje aktualizacji oprogramowania i należy ją zainstalować. ciNotPresentStan wskazuje brakujące aktualizacje. W poniższej tabeli przedstawiono inne możliwe wartości właściwości ComplianceState aktualizacji oprogramowania. Tylko wartości 0, 1 i 2 są używane przez program do zarządzania aktualizacjami oprogramowania.

Wartość Stan
0 ciNotPresent
1 ciPresent
2 ciPresenceUnknown (również używany do nie dotyczy)
3 ciEvaluationError
4 ciNotEvaluated
5 ciNotUpdated
6 ciNotConfigured

ContentSize
Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Rozmiar zawartości aktualizacji oprogramowania.

Uwaga

Ta właściwość jest dostępna tylko po pobraniu aktualizacji oprogramowania do Configuration Manager pamięci podręcznej, a nie przed.

Deadline
Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Data i godzina zainstalowania aktualizacji oprogramowania.

Description
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Opis aktualizacji oprogramowania.

ErrorCode
Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Kod błędu (jeśli istnieje) skojarzony z aktualizacją oprogramowania.

EvaluationState
Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Stan oceny aktualizacji oprogramowania. Po wywołaniu metody InstallUpdates w CCM_SoftwareUpdatesManager klasie w celu wyzwolenia instalacji aktualizacji oprogramowania, można użyć właściwości EvaluationState, PercentComplete i ErrorCode do monitorowania postępu aktualizacji.

Uwaga

Właściwość EvaluationState jest przeznaczona tylko do oceny postępu, a nie do wyszukiwania stanu zgodności aktualizacji oprogramowania. Gdy aktualizacja oprogramowania nie jest w stanie postępu, wartość EvaluationState jest none lub, w zależności od available tego, czy w dowolnym momencie w przeszłości wystąpił postęp. Nie dotyczy to stanu zgodności. Ponadto, jeśli aktualizacja oprogramowania została pobrana w czasie aktywacji, wartość EvaluationState jest równa none . Ta wartość zmienia się tylko po próbie instalacji aktualizacji oprogramowania.

W poniższej tabeli przedstawiono wartości właściwości EvaluationState dla aktualizacji oprogramowania.

Wartość Stan
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
Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

true Jeśli aktualizacja oprogramowania jest WYŁĄCZna; w przeciwnym razie false . Nie można zainstalować wyłącznej aktualizacji jednocześnie z innymi aktualizacjami.

FullName
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Ta właściwość nie jest używana.

IsUpgrade
Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: brak

Wskazuje, czy aktualizacja oprogramowania jest uaktualnieniem.

MaxExecutionTime
Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Maksymalny czas wymagany do uruchomienia aktualizacji oprogramowania.

Name
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Nazwa aktualizacji oprogramowania.

NextUserScheduledTime
Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Data i godzina odroczenia określonych aktualizacji oprogramowania na godziny niepracy (NBH). Ta właściwość pokazuje następny NBH do użycia.

NotifyUser
Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

true powiadomienia o aktualizacji oprogramowania są wyświetlane użytkownikowi; w przeciwnym razie false .

Uwaga

Jeśli UserUIExperience jest ustawiona na false , NotifyUser jest ignorowana.

OverrideServiceWindows
Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

true Jeśli można zainstalować aktualizację oprogramowania poza oknami obsługi; w przeciwnym razie false .

PercentComplete
Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Procent ukończenia instalacji aktualizacji oprogramowania.

Publisher
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Wydawca aktualizacji oprogramowania.

RebootOutsideServiceWindows
Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

true Jeśli aktualizacja oprogramowania może zostać ponownie uruchomiona poza oknami obsługi; w przeciwnym razie false .

RestartDeadline
Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Data i godzina ponownego uruchomienia komputera po zakończeniu instalacji aktualizacji oprogramowania.

StartTime
Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Data i godzina udostępnienia aktualizacji oprogramowania użytkownikowi.

UpdateID
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Identyfikator aktualizacji oprogramowania.

URL
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Adres URL aktualizacji oprogramowania.

UserUIExperience
Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

true Jeśli aktualizacja oprogramowania jest widoczna w programie Software Center; w przeciwnym razie false .

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

Aby uzyskać więcej informacji, zobacz wymagania dotyczące środowiska uruchomieniowego klienta Configuration Manager.

Wymagania dotyczące programowania

Aby uzyskać więcej informacji, zobacz Configuration Manager wymagania dotyczące programowania klientów.