Udostępnij za pośrednictwem


klasa WMI klienta CCM_SoftwareUpdate

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

Wyliczenie tej klasy daje wszystkie aktualizacje, które mają zastosowanie i muszą zostać zainstalowane. Możesz użyć polecenia GetObject do wykonywania zapytań o pojedynczą aktualizację UpdateID na podstawie właściwości . Każdy obiekt aktualizacji ma właściwości równoważne staremu interfejsowi ICCMTargetedUpdateCOM. Aby uzyskać więcej informacji na temat poszczególnych właściwości, zobacz interfejs ICCMTargetedUpdate Configuration Manager 2007. Tutaj wymieniono tylko różnice między klasami ICCMTargetedUpdate i CCM_SoftwareUpdate .

Ważna

Zestaw SDK po stronie klienta aktualizacji oprogramowania zwróci tylko zestaw aktualizacji wdrożonych na kliencie z serwera lokacji Configuration Manager i które mają zastosowanie i nie zostały jeszcze zainstalowane na kliencie.

Poniższa składnia jest uproszczona z kodu MOF (Managed Object Format) i zawiera wszystkie dziedziczone właściwości.

Składni

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

Klasa CCM_SoftwareUpdate nie definiuje żadnych metod.

Właściwości

ArticleID
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Identyfikator artykułu baza wiedzy aktualizacji oprogramowania. Maksymalna długość tej wartości to 64 znaki.

BulletinID
Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Identyfikator biuletynu aktualizacji zabezpieczeń wydanych przez Microsoft. Maksymalna długość tej wartości to 64 znaki. Wartość domyślna to None.

ComplianceState
Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

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

Value Stan
0 ciNotPresent
1 ciPresent
2 ciPresenceUnknown (również używany jako 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 wcześniej.

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 klasie w CCM_SoftwareUpdatesManager celu wyzwolenia instalacji aktualizacji oprogramowania właściwości EvaluationState, PercentComplete i ErrorCode mogą służyć do monitorowania postępu aktualizacji.

Uwaga

Właściwość EvaluationState służy tylko do oceny postępu, a nie do znajdowania stanu zgodności aktualizacji oprogramowania. Jeśli aktualizacja oprogramowania nie jest w stanie postępu, wartość EvaluationState wynosi none lub available, w zależności od tego, czy w jakimkolwiek momencie w przeszłości nastąpił jakikolwiek postęp. Nie jest to związane ze stanem zgodności. Ponadto jeśli aktualizacja oprogramowania została pobrana w czasie aktywacji, wartość EvaluationState to none. Ta wartość zmienia się tylko po podjęciu próby zainstalowania aktualizacji oprogramowania.

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

Value 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]

truejeśli aktualizacja oprogramowania jest WYŁĄCZNA; w przeciwnym razie . false Nie można zainstalować aktualizacji wyłącznej w tym samym czasie, co inne aktualizacje.

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 inne niż godziny pracy (NBH). Ta właściwość pokazuje następny NBH do użycia.

NotifyUser
Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

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

Uwaga

Jeśli UserUIExperience jest ustawiona wartość false, NotifyUser jest ignorowana.

OverrideServiceWindows
Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

truejeśli aktualizację oprogramowania można zainstalować 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]

truejeś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 zainstalowaniu 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]

truejeśli aktualizacja oprogramowania jest widoczna w Centrum oprogramowania; w przeciwnym razie . false

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

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

Wymagania programistyczne

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