Classe WMI do servidor SMS_Collection

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

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) 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:

• Método AddMembershipRule: adiciona uma nova regra à CollectionRules propriedade de SMS_Collection.
• Método AddMembershipRules: Adiciona várias novas regras à CollectionRules propriedade de SMS_Collection.
• Método ApproveClients: aprova computadores cliente especificados para ingressar no site.
• Método BlockClients: impede que computadores cliente especificados se comuniquem com o site.
• Método ChangeOwnership: altera a propriedade dos computadores para um proprietário do dispositivo.
• Método ClearDeploymentLocksForCollection: Limpa os bloqueios de implantação de uma coleção selecionada.
• Método ClearDeviceCategory: limpa uma categoria de um conjunto de dispositivos.
• Método ClearLastNBSAdvForCollection: Limpa a última implantação do PXE para uma coleção selecionada.
• Método ClearLastNBSAdvForMachines: Limpa a última implantação do PXE para computadores cliente selecionados.
• Método ClientEditions: recupera uma lista de edições do cliente.
• Método CreateCCR: cria uma CCR (solicitação de configuração do cliente) para um recurso específico.
• Método CreateCCRs: gera CCRs (solicitações de configuração do cliente) para os computadores da coleção.
• Método DeleteAllMembers: exclui todos os membros, ou seja, recursos e dados de descoberta, para a coleção.
• Método DeleteMembershipRule: Exclui uma regra de associação da coleção.
• Método DeleteMembershipRules: exclui várias regras de associação da coleção.
• Método FindResourceSite: obtém informações de código de site para um computador do banco de dados do site.
• Método FindMachineSite: obtém informações de código do site para recursos do banco de dados do site.
• Método GetDependency: A partir da versão 2010, obtenha as informações de relação de coleção das quais a coleção de entrada depende.
• Método GetDependent: A partir da versão 2010, obtenha as informações de relação de coleção que dependem da coleção de entrada.
• Método GetNumResults: Obtém uma contagem de todos os membros em uma coleção, excluindo subcoleções.
• Método GenerateCCRByName: gera uma solicitação de configuração do cliente por nome de computador.
• Método GetTotalNumResults: Obtém uma contagem de todos os membros em uma coleção, incluindo subcoleções.
• Método ReassignClientsToSite: Reatribui o site para os clientes na lista.
• Método RequestRefresh: Dispara uma reavaliação da associação da coleção pelo componente avaliador de coleção do Configuration Manager.
• Método SetDeviceCategory: atribui uma categoria a um conjunto de dispositivos.
• Método SetMemberOrder: Define a ordem dos membros de uma coleção.
• Método UpdateVisibilityInEPDashBoard: mostrar essa coleção no dashboard de proteção do ponto de extremidade.
• Método VerifyNoCircularDependencies: verifica se nenhuma dependência circular será formada se uma coleção for o pai de outra.

Propriedades

CollectionID

Tipo de dados: String

Tipo de acesso: somente leitura

Qualificadores: [chave, leitura]

A ID exclusiva gerada automaticamente para essa coleção que contém oito caracteres.

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

CollectionRules

Tipo de dados: SMS_CollectionRule matriz

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

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

CollectionType

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [read, enumeration]

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.

CollectionVariablesCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Eliminatórias: [leia]

Contagem de variáveis da coleção.

Comment

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

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

CurrentStatus

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [read, enumeration]

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

FullEvaluationRunTime

Tipo de dados: Uint32

Tipo de acesso: somente leitura

Eliminatórias: [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

Eliminatórias: [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

Eliminatórias: [leia]

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

FullEvaluationLastRefreshTime

Tipo de dados: Datetime

Tipo de acesso: somente leitura

Eliminatórias: [leia]

A partir da versão 2010, a última atualização de avaliação completa é necessária.

FullEvaluationNextRefreshTime

Tipo de dados: Datetime

Tipo de acesso: somente leitura

Eliminatórias: [leia]

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

HasProvisionedMember

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Eliminatórias: [leia]

true se essa coleção tiver membros provisionados.

IncludeExcludeCollectionsCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Eliminatórias: [leia]

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

IncrementalEvaluationRunTime

Tipo de dados: Uint32

Tipo de acesso: somente leitura

Eliminatórias: [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

Eliminatórias: [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

Eliminatórias: [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

Eliminatórias: [leia]

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

IsBuiltIn

Tipo de dados: Boolean

Tipo de acesso: Read-Only

Eliminatórias: [leia]

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

IsReferenceCollection

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Eliminatórias: [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

Eliminatórias: [grande, preguiçoso]

Um espaço de dados para extensibilidade do parceiro.

ISVDataSize

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

O tamanho do ISVData.

ISVString

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: nenhuma

Uma cadeia de caracteres para extensibilidade do parceiro.

LastChangeTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Data e hora de quando a coleta foi alterada pela última vez de alguma forma.

LastMemberChangeTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

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

LastRefreshTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

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

LimitToCollectionID

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

A ID da coleção limitante.

LimitToCollectionName

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

O nome da coleção limitante.

LocalMemberCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Eliminatórias: [leia]

Contagem de membros visíveis no site local.

MemberClassName

Tipo de dados: String

Tipo de acesso: somente leitura

Eliminatórias: [leia]

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

MemberCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Eliminatórias: [leia]

A contagem dos membros da coleção.

MonitoringFlags

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Eliminatórias: [leia]

Habilita a coleta para determinados tipos de monitoramento.

Name

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Not_null]

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

OwnedByThisSite

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificador: Nenhum

truese a coleção foi originada no site local do Configuration Manager. 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: [max(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ó atualizará a associação da 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 a agenda, defina a RefreshType propriedade como periódica (2).

RefreshType

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificadores: [lazy, enumeration]

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

Para basear a atualização no agendamento especificado 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 é implementada.

ServiceWindowsCount

Tipo de dados: SInt32

Tipo de acesso: somente leitura

Eliminatórias: [leia]

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

UseCluster

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Eliminatórias: [leia]

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

Comentários

Os qualificadores de classe para esta classe incluem:

• Protegido

Para obter mais informações sobre os qualificadores de classe e os qualificadores de propriedade incluídos na seção de propriedades, consulte Qualificadores de classe e propriedade do Configuration Manager.

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 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. Esta propriedade não é recuperada quando seu aplicativo enumera SMS_Collection. Para obter as regras de coleta para uma coleção, seu aplicativo deve usar IWbemServices::GetObject ou SWbemServices::Get. Para obter mais informações, consulte Qualificadores de contexto do Configuration Manager.

Requisitos

Requisitos de tempo de execução

Para obter mais informações, consulte Requisitos de tempo de execução do servidor do Configuration Manager.

Requisitos de desenvolvimento

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

Confira também

Classe WMI do servidor SMS_CollectionRule