Classe WMI do servidor SMS_Collection

  • Artigo

A SMS_Collection classe WMI é uma classe de servidor provedor de SMS no Configuration Manager. Ele representa uma coleção de recursos relacionados logicamente por regras, juntamente com informações de coleta.

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

Sintaxe

Class SMS_Collection : SMS_BaseClass
{
   String CollectionID;
   SMS_CollectionRule CollectionRules[];
   UInt32 CollectionType;
   SInt32 CollectionVariablesCount;
   String Comment;
   UInt32 CurrentStatus;
   Uint32 FullEvaluationRunTime;
   Uint32 FullEvaluationMemberChanges;
   DateTime FullEvaluationMemberChangeTime;
   DateTime FullEvaluationLastRefreshTime;
   DateTime FullEvaluationNextRefreshTime;
   Boolean HasProvisionedMember;
   SInt32 IncludeExcludeCollectionsCount;
   Uint32 IncrementalEvaluationRunTime;
   Uint32 IncrementalEvaluationMemberChanges;
   DateTime IncrementalEvaluationMemberChangeTime;
   DateTime IncrementalEvaluationLastRefreshTime;
   Boolean IsBuiltIn;
   Boolean IsReferenceCollection;
   UInt8 ISVData[];
   UInt32 ISVDataSize;
   String ISVString;
   DateTime LastChangeTime;
   DateTime LastMemberChangeTime;
   DateTime LastRefreshTime;
   String LimitToCollectionID;
   String LimitToCollectionName;
   SInt32 LocalMemberCount;
   String MemberClassName;
   SInt32 MemberCount;
   UInt32 MonitoringFlags;
   String Name;
   Boolean OwnedByThisSite;
   SInt32 PowerConfigsCount;
   SMS_ScheduleToken RefreshSchedule[];
   UInt32 RefreshType;
   Boolean ReplicateToSubSites;
   SInt32 ServiceWindowsCount;
   Boolean UseCluster;
};

Métodos

Os seguintes métodos estão disponíveis na SMS_Collection classe:

Propriedades

CollectionID

Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [chave, leitura]

A ID autogenerada exclusiva para esta coleção que contém oito caracteres.

O formato da ID da coleção é o código do site que criou a coleção seguida por um número de série hexadecimal de cinco dígitos, por exemplo, JAX0002C. As coleções de Configuration Manager padrão usam o SMS de prefixo, por exemplo, SMS00001.

CollectionRules

Tipo de dados: SMS_CollectionRule matriz

Tipo de acesso: Leitura/Gravação

Qualificadores: [preguiçoso]

SMS_CollectionRule objetos de classe WMI do servidor definindo os critérios de associação para a coleção.

CollectionType

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura, enumeração]

O tipo da coleção. Ao criar ou modificar coleções, o tipo de coleção deve ser o mesmo para todas as coleções incluídas, excluídas e limitadas. Tipos de coleção incompatíveis não são permitidos.

Valor Tipo de coleção
0 Outros
1 User
2 Device

CollectionVariablesCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Qualificadores: [leia]

Contagem de variáveis de coleção.

Comment

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Qualificadores: Nenhum

Comentário geral ou observe que documenta a coleção.

CurrentStatus

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leitura, enumeração]

Status atual da coleção. Os valores possíveis são:

Valor Status atual
0 Nenhum
1 Pronto
2 Atualizando
3 Salvar
4 Avaliar
5 Aguardando atualização
6 Excluir
7 Membro de acrescentação
8 Consultar

FullEvaluationRunTime

Tipo de dados: Uint32

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, o tempo de execução de avaliação completo em segundos.

FullEvaluationMemberChanges

Tipo de dados: Uint32

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, o número de membros muda da avaliação completa.

FullEvaluationMemberChangeTime

Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, a última vez que a associação mudou de avaliação completa.

FullEvaluationLastRefreshTime

Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, a avaliação completa da última atualização.

FullEvaluationNextRefreshTime

Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, a avaliação completa será na próxima atualização.

HasProvisionedMember

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leia]

true se essa coleção tiver membros provisionados.

IncludeExcludeCollectionsCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Qualificadores: [leia]

Contagem de coleções incluídas e excluídas com esta.

IncrementalEvaluationRunTime

Tipo de dados: Uint32

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, o tempo de execução de avaliação incremental em segundos.

IncrementalEvaluationMemberChanges

Tipo de dados: Uint32

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, o número de membros muda da avaliação incremental.

IncrementalEvaluationMemberChangeTime

Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, a última vez que a associação mudou de avaliação incremental.

IncrementalEvaluationLastRefreshTime

Tipo de dados: Datetime

Tipo de acesso: somente leitura

Qualificadores: [leia]

A partir da versão 2010, a avaliação incremental última atualização.

IsBuiltIn

Tipo de dados: Boolean

Tipo de acesso: Read-Only

Qualificadores: [leia]

Quando esse valor é true, a coleção é interna. Por exemplo, Todos os Sistemas.

IsReferenceCollection

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leia]

Quando esse valor é true, a coleção não é limitada por outra coleção.

ISVData

Tipo de dados: UInt8[]

Tipo de acesso: Leitura/Gravação

Qualificadores: [grande, preguiçoso]

Um espaço de dados para extensibilidade de parceiro.

ISVDataSize

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificadores: [preguiçoso]

O tamanho ISVData.

ISVString

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Qualificadores: nenhum

Uma cadeia de caracteres para extensibilidade do parceiro.

LastChangeTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Qualificadores: Nenhum

Data e hora de quando a coleção foi alterada pela última vez de qualquer forma.

LastMemberChangeTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Qualificadores: Nenhum

Data e hora de quando a associação de coleção foi alterada pela última vez.

LastRefreshTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Qualificadores: Nenhum

Data e hora de quando a associação de coleção foi atualizada pela última vez.

LimitToCollectionID

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Qualificadores: Nenhum

A ID da coleção de limitação.

LimitToCollectionName

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Qualificadores: Nenhum

O nome da coleção de limitação.

LocalMemberCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Qualificadores: [leia]

Contagem de membros visíveis no site local.

MemberClassName

Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [leia]

O nome da classe que contém os membros desta coleção. Configuration Manager não armazena membros da coleção no SMS_Collection. O site gera dinamicamente o nome da classe membro e é derivado de SMS_CM_RES_COLL_CollectionID classe WMI do servidor.

MemberCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Qualificadores: [leia]

A contagem dos membros da coleção.

MonitoringFlags

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leia]

Habilita a coleção para determinados tipos de monitoramento.

Name

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Qualificadores: [Not_null]

O nome da coleção. Esse valor representa a coleção no console Configuration Manager e deve ser exclusivo.

OwnedByThisSite

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificador: Nenhum

truese a coleção tiver se originado no site de Configuration Manager local. O valor padrão é false.

PowerConfigsCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Qualificador: [leia]

Uma contagem das configurações de energia.

RefreshSchedule

Tipo de dados: SMS_ScheduleToken matriz

Tipo de acesso: Leitura/Gravação

Qualificadores: [máximo(15), preguiçoso]

SMS_ScheduleToken objetos de classe WMI do servidor indicando uma atualização ou agendamento de atualização para a coleção. O site só atualiza a associação de coleção se o aplicativo especificar uma agenda ou chamar o método RequestRefresh na classe SMS_Collection . Para que o avaliador de coleção use o agendamento, defina a RefreshType propriedade como periódica (2).

RefreshType

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificadores: [preguiçoso, enumeração]

Esse valor indica como Configuration Manager atualiza a coleção. O valor padrão é manual (1). Valores possíveis:

Valor Tipo de atualização
1 Manual
2 Periódica
4 Atualização constante

Para basear a atualização na agenda especificada em RefreshSchedule, defina essa propriedade como periódica (2). Se você definir essa propriedade como manual (1), atualize manualmente a coleção com o método RequestRefresh.

ReplicateToSubSites

Essa propriedade não foi implementada.

ServiceWindowsCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Qualificadores: [leia]

Contagem de janelas de manutenção para esta coleção.

UseCluster

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Qualificadores: [leia]

Especifica que essa coleção é um grupo de servidores.

Comentários

As qualificatórias de classe para esta classe incluem:

  • Protegido

Para obter mais informações sobre as qualificatórias de classe e as qualificatórias de propriedade incluídas na seção propriedades, consulte Configuration Manager classificadores de classe e propriedade.

As informações de coleção representadas por essa classe incluem a agenda de atualização e os membros, representados por objetos de classe WMI do servidor SMS_CM_RES_COLL_CollectionID . Seu aplicativo pode usar uma coleção para direcionar recursos para distribuição de software.

Ao executar uma consulta em uma coleção dinâmica representada por SMS_Collection, verifique se o Provedor de SMS está carregado ou se outro método ou consulta já foi executado.

O aplicativo deve usar os SMS_Collection métodos para adicionar, atualizar ou excluir regras de associação definidas pela CollectionRules propriedade. Essa propriedade não é recuperada quando seu aplicativo enumera SMS_Collection. Para obter as regras de coleção de uma coleção, seu aplicativo deve usar IWbemServices::GetObject ou SWbemServices::Get. Para obter mais informações, consulte qualificadores de contexto Configuration Manager.

Requisitos

Requisitos de runtime

Para obter mais informações, consulte Configuration Manager requisitos de runtime do servidor.

Requisitos de desenvolvimento

Para obter mais informações, consulte Configuration Manager requisitos de desenvolvimento do servidor.

Confira também

Classe WMI do servidor SMS_CollectionRule