CCM_SoftwareUpdate classe WMI do cliente

A CCM_SoftwareUpdate classe WMI é uma classe de cliente, no Configuration Manager, que representa uma atualização de software.

Enumerar essa classe fornece todas as atualizações aplicáveis e que precisam ser instaladas. Você pode usar GetObject para consultar uma atualização individual com base na UpdateID propriedade. Cada objeto update tem propriedades equivalentes à interface COM ICCMTargetedUpdate antiga. Para obter mais detalhes sobre propriedades individuais, você pode consultar a interface ICCMTargetedUpdate do Configuration Manager 2007. Listamos aqui apenas as diferenças entre ICCMTargetedUpdate e CCM_SoftwareUpdate classes.

Importante

O SDK do lado do cliente de atualização de software retornará apenas o conjunto de atualizações que são implantadas para o cliente a partir do servidor de site do Configuration Manager e são aplicáveis e ainda não estão instalados no cliente.

A sintaxe a seguir é simplificada a partir do código Formato de Objeto Gerenciado (MOF) e inclui todas as propriedades herdadas.

Sintaxe

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

Methods

A CCM_SoftwareUpdate classe não define nenhum método.

Propriedades

ArticleID
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Identificador do artigo da base de dados de conhecimento para a atualização de software. O comprimento máximo para esse valor é de 64 caracteres.

BulletinID
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Identificador do boletim para atualizações de segurança lançadas pela Microsoft. O comprimento máximo para esse valor é de 64 caracteres. O valor padrão é None.

ComplianceState
Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Estado de conformidade da atualização de software que indica se a atualização de software está ausente e precisa ser instalada. O ciNotPresent estado indica atualizações ausentes. A tabela a seguir mostra outros valores possíveis para a propriedade ComplianceState para atualizações de software. Somente os valores 0, 1 e 2 são usados pelo gerenciamento de atualização de software.

Valor Estado
0 ciNotPresent
1 ciPresent
2 ciPresenceUnknown (também usado para não aplicável)
3 ciEvaluationError
4 ciNotEvaluated
5 ciNotUpdated
6 ciNotConfigured

ContentSize
Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Tamanho do conteúdo da atualização de software.

Observação

Essa propriedade só estará disponível depois que a atualização de software for baixada no cache do Configuration Manager, não antes.

Deadline
Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Data e hora em que a atualização de software está instalada.

Description
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Descrição da atualização de software.

ErrorCode
Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Código de erro, se for o caso, associado à atualização de software.

EvaluationState
Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Estado de avaliação da atualização de software. Depois que o método InstallUpdates na classe for chamado para disparar a instalação de atualizações de software, as propriedades CCM_SoftwareUpdatesManager EvaluationState, PercentComplete e ErrorCode poderão ser usadas para monitorar o andamento da atualização.

Observação

A propriedade EvaluationState é destinada apenas para avaliar o progresso, não para encontrar o estado de conformidade de uma atualização de software. Quando uma atualização de software não está em um estado de progresso, o valor de EvaluationState é ou , dependendo se houve algum progresso em algum momento none available no passado. Isso não está relacionado ao estado de conformidade. Além disso, se uma atualização de software foi baixada no momento da ativação, o valor de EvaluationState será none . Esse valor só muda quando uma instalação é tentada na atualização de software.

A tabela a seguir mostra os valores da propriedade EvaluationState para atualizações de software.

Valor Estado
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
Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leitura]

true se a atualização de software for EXCLUSIVA; caso contrário, false . Uma atualização exclusiva não pode ser instalada ao mesmo tempo que outras atualizações.

FullName
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Essa propriedade não é usada.

IsUpgrade
Tipo de dados: Boolean

Tipo de acesso: Leitura/gravação

Qualificadores: nenhum

Indica se a atualização de software é uma atualização.

MaxExecutionTime
Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Tempo máximo necessário para a atualização de software ser executado.

Name
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Nome da atualização de software.

NextUserScheduledTime
Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Data e hora em que um usuário adia atualizações de software específicas para o horário não comercial (NBH). Esta propriedade mostra o próximo NBH a ser usado.

NotifyUser
Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leitura]

true se as notificações para a atualização de software são mostradas ao usuário; caso contrário, false .

Observação

Se UserUIExperience estiver definido como , será false NotifyUser ignorado.

OverrideServiceWindows
Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leitura]

true se a atualização de software puder ser instalada fora das janelas de manutenção; caso contrário, false .

PercentComplete
Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Porcentagem de conclusão da instalação da atualização de software.

Publisher
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Publisher da atualização de software.

RebootOutsideServiceWindows
Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leitura]

true se a atualização de software puder reiniciar fora das janelas de manutenção; caso contrário, false .

RestartDeadline
Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Data e hora em que um computador é reiniciado após a instalação da atualização de software.

StartTime
Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Data e hora em que a atualização de software é disponibilizada para o usuário.

UpdateID
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

Identificador da atualização de software.

URL
Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leitura]

URL para uma atualização de software.

UserUIExperience
Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leitura]

true se a atualização de software estiver visível no centro de software; caso contrário, false .

Requirements

Requisitos de tempo de execução

Para obter mais informações, consulte Configuration Manager Client Runtime Requirements.

Requisitos de desenvolvimento

Para obter mais informações, consulte Configuration Manager Client Development Requirements.