SMS_Collection server WMI class (Classe WMI de servidor SMS_Collection)
A SMS_Collection
classe WMI é uma classe de servidor fornecedor de SMS no Gestor de Configuração. Representa uma recolha de recursos relacionados logicamente por regras, juntamente com informações de recolha.
A seguinte sintaxe é simplificada a partir do código do formato MOF (Managed Object Format) e inclui todas as propriedades herdadas.
Syntax
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 deSMS_Collection
. - Método AddMembershipRules: Adiciona múltiplas novas regras à
CollectionRules
propriedade deSMS_Collection
. - Método de Aprovação DeClients: Aprova computadores clientes especificados para se juntar ao site.
- Método De Bloqueio :Bloqueia os computadores clientes especificados de comunicação com o site.
- Método ChangeOwnership: Muda a propriedade das máquinas para o proprietário do dispositivo.
- ClearDeploymentLocksForCollection method: Limpa os bloqueios de implantação para uma coleção selecionada.
- Método ClearDeviceCategoria: Limpa uma categoria a partir de um conjunto de dispositivos.
- Método ClearLastNBSAdvForCollection: Limpa a última implantação de PXE para uma coleção selecionada.
- Método ClearLastNBSAdvForMachines: Limpa a última implementação de PXE para computadores clientes selecionados.
- Método de Edição de Clientes: Recupera uma lista de edições de clientes.
- Método CreateCCR: Cria um pedido de configuração do cliente (CCR) para um determinado recurso.
- Método CreateCCRs: Gera pedidos de configuração do cliente (CCRs) para os computadores da coleção.
- DeleteAllMembers método: Elimina todos os membros, isto é, recursos e dados de descoberta, para a recolha.
- DeleteMembershipRule method: Elimina uma regra de adesão da coleção.
- DeleteMembershipRules method: Elimina várias regras de adesão da coleção.
- Método FindResourceSite: Obtém informações de código do site para um computador a partir da base de dados do site.
- Método FindMachineSite: Obtém informações do código do site para recursos a partir da base de dados do site.
- Método GetDependency: A partir da versão 2010, obtenha a informação sobre a relação de recolha de que depende a coleção de entrada.
- Método GetDependent: A partir da versão 2010, obtenha a informação sobre a relação de recolha que depende da coleção de entradas.
- Método GetNumResults: Obtém uma contagem de todos os membros numa coleção, excluindo subcollectos.
- Método GenerateCCRByName: Gera um pedido de configuração do cliente por nome de computador.
- Método GetTotalNumResults: Obtém uma contagem de todos os membros numa coleção, incluindo subcollectos.
- Método ReassignIentsToSite: Reatribui o site para os clientes da lista.
- Método RequestRefresh: Desencadeia uma reavaliação da adesão à recolha pelo componente avaliador de recolha do Gestor de Configuração.
- Método SetDeviceCategoria: Atribui uma categoria a um conjunto de dispositivos.
- Método SetMemberOrder: Define a ordem dos membros de uma coleção.
- Método UpdateVisibilityInEPDashBoard: Mostre esta coleção no painel de proteção do ponto final.
- Verificar o método Dependências NoCirculares: Verifica se não se formam dependências circulares se uma coleção for o pai de outra.
Propriedades
CollectionID
Tipo de dados: String
Tipo de acesso: Só de leitura
Eliminatórias: [chave, ler]
O ID autogerado único para esta coleção que contém oito caracteres.
O formato do ID de recolha é o código do site que criou a coleção seguido de um número de série hexadecimal de cinco dígitos, por exemplo, JAX0002C
. As coleções de Gestor de Configuração predefinido utilizam o prefixo SMS, por exemplo, SMS00001
.
CollectionRules
Tipo de dados: SMS_CollectionRule
matriz
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
SMS_CollectionRule servidor de objetos de classe WMI que definem os critérios de adesão para a coleção.
CollectionType
Tipo de dados: UInt32
Tipo de acesso: Só de leitura
Eliminatórias: [ler, enumerar]
O tipo da coleção. Ao criar ou modificar coleções, o tipo de recolha deve ser o mesmo para todas as coleções incluídas, excluídas e limitadas. Não são permitidos tipos de recolha desajustados.
Valor | Tipo de coleção |
---|---|
0 |
Outro |
1 |
Utilizador |
2 |
Dispositivo |
CollectionVariablesCount
Tipo de dados: SInt32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Contagem de variáveis de coleção.
Comment
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Qualificadores: Nenhum
Comentário geral ou nota que documenta a coleção.
CurrentStatus
Tipo de dados: UInt32
Tipo de acesso: Só de leitura
Eliminatórias: [ler, enumerar]
Estado atual da coleção. Os valores possíveis são:
Valor | Estado atual |
---|---|
0 |
Nenhuma |
1 |
Pronto |
2 |
A atualizar |
3 |
Economia |
4 |
Avaliação |
5 |
Aguardando atualização |
6 |
Eliminar |
7 |
Membro da Appending |
8 |
A consultar |
FullEvaluationRunTime
Tipo de dados: Uint32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, a avaliação completa funciona em segundos.
FullEvaluationMemberChanges
Tipo de dados: Uint32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, o número de membros muda de avaliação completa.
FullEvaluationMemberChangeTime
Tipo de dados: Datetime
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, a última vez que a adesão mudou de avaliação completa.
FullEvaluationLastRefreshTime
Tipo de dados: Datetime
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, a avaliação completa no último tempo de atualização.
FullEvaluationNextRefreshTime
Tipo de dados: Datetime
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, a avaliação completa da próxima hora.
HasProvisionedMember
Tipo de dados: Boolean
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
true
se esta coleção tiver membros provisionados.
IncludeExcludeCollectionsCount
Tipo de dados: SInt32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Contagem de coleções que estão incluídas e excluídas com esta.
IncrementalEvaluationRunTime
Tipo de dados: Uint32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, a avaliação incremental funciona em segundos.
IncrementalEvaluationMemberChanges
Tipo de dados: Uint32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, o número de membros muda de avaliação incremental.
IncrementalEvaluationMemberChangeTime
Tipo de dados: Datetime
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, a última vez que a adesão mudou de avaliação incremental.
IncrementalEvaluationLastRefreshTime
Tipo de dados: Datetime
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A partir da versão 2010, a avaliação incremental última hora de atualização.
IsBuiltIn
Tipo de dados: Boolean
Tipo de acesso: Read-Only
Qualificadores: [leitura]
Quando este valor true
é, a coleção é incorporada. Por exemplo, Todos os Sistemas.
IsReferenceCollection
Tipo de dados: Boolean
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Quando este valor true
é, a coleção não é limitada por outra coleção.
ISVData
Tipo de dados: UInt8[]
Tipo de acesso: Leitura/Escrita
Eliminatórias: [grande, preguiçoso]
Um espaço de dados para a extensibilidade do parceiro.
ISVDataSize
Tipo de dados: UInt32
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
O tamanho ISVData.
ISVString
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: nenhuma
Uma corda para a extensibilidade do parceiro.
LastChangeTime
Tipo de dados: DateTime
Tipo de acesso: Leitura/Escrita
Qualificadores: Nenhum
Data e hora de quando a coleção foi alterada pela última vez de alguma forma.
LastMemberChangeTime
Tipo de dados: DateTime
Tipo de acesso: Leitura/Escrita
Qualificadores: Nenhum
Data e hora de quando a adesão foi alterada pela última vez.
LastRefreshTime
Tipo de dados: DateTime
Tipo de acesso: Leitura/Escrita
Qualificadores: Nenhum
Data e hora de quando a adesão foi renovada pela última vez.
LimitToCollectionID
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Qualificadores: Nenhum
A identificação da coleção limitativa.
LimitToCollectionName
Tipo de dados: DateTime
Tipo de acesso: Leitura/Escrita
Qualificadores: Nenhum
O nome da coleção limitativa.
LocalMemberCount
Tipo de dados: SInt32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Contagem de membros visíveis no local.
MemberClassName
Tipo de dados: String
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
O nome da classe que contém os membros desta coleção. O Gestor de Configuração não armazena membros da recolha em SMS_Collection. O site gera dinamicamente o nome da classe dos membros, e é derivado de SMS_CM_RES_COLL_CollectionID classe WMI do servidor.
MemberCount
Tipo de dados: SInt32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
A contagem dos membros da coleção.
MonitoringFlags
Tipo de dados: UInt32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Permite a recolha para certos tipos de monitorização.
Name
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: [Not_null]
O nome da coleção. Este valor representa a coleção na consola Do Gestor de Configuração e deve ser único.
OwnedByThisSite
Tipo de dados: Boolean
Tipo de acesso: Leitura/Escrita
Eliminatória: Nenhum
true
se a coleção tiver origem no site local do Gestor de Configuração. O valor predefinido é false
.
PowerConfigsCount
Tipo de dados: SInt32
Tipo de acesso: Só de leitura
Eliminatória: [ler]
Uma contagem das configurações de potência.
RefreshSchedule
Tipo de dados: SMS_ScheduleToken
matriz
Tipo de acesso: Leitura/Escrita
Qualificadores: [máx(15), em diferido]
SMS_ScheduleToken objetos da classe WMI do servidor indicando uma atualização ou um calendário de atualização para a coleção. O site só atualiza a adesão à recolha se a sua aplicação especificar um horário ou ligar para o método RequestRefresh na classe SMS_Collection. Para que o avaliador de recolha utilize o horário, desa estale o RefreshType
imóvel periódico 2
().
RefreshType
Tipo de dados: UInt32
Tipo de acesso: Leitura/Escrita
Eliminatórias: [preguiçoso, enumeração]
Este valor indica como o Gestor de Configuração atualiza a coleção. O valor predefinido é manual 1
(). Valores possíveis:
Valor | Tipo de atualização |
---|---|
1 |
Manual |
2 |
Periódico |
4 |
Atualização constante |
Para basear a atualização no horário especificado em RefreshSchedule
, definir este imóvel periodicamente 2
(). Se definir este imóvel como manual 1
(, atualizar manualmente a coleção com o método RequestRefresh.
ReplicateToSubSites
Esta propriedade não é implementada.
ServiceWindowsCount
Tipo de dados: SInt32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Contagem de janelas de manutenção para esta coleção.
UseCluster
Tipo de dados: Boolean
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Especifica que esta coleção é um grupo de servidores.
Observações
Os qualificadores de classe desta classe incluem:
- Protegido
Para obter mais informações sobre as classificativas de classe e as classificativas de propriedade incluídas na secção de propriedades, consulte a classe De Gestor de Configuração e as classificações de propriedade.
As informações de recolha representadas por esta classe incluem o horário de atualização e os membros, representados por SMS_CM_RES_COLL_CollectionID servidor de objetos da classe WMI. A sua aplicação pode usar uma coleção para direcionar recursos para distribuição de software.
Quando fizer uma consulta contra uma coleção dinâmica representada por SMS_Collection
, certifique-se de que o Fornecedor SMS está carregado ou que outro método ou consulta já foi executado.
A aplicação deve usar os SMS_Collection
métodos para adicionar, atualizar ou eliminar as regras de adesão definidas pela CollectionRules
propriedade. Esta propriedade não é recuperada quando a sua aplicação SMS_Collection
enumera. Para obter as regras de cobrança de uma coleção, a sua aplicação deve utilizar IWbemServices::GetObject
ou SWbemServices::Get
. Para obter mais informações, consulte as classificações de contexto do Gestor de Configuração.
Requisitos
Requisitos de tempo de execução
Para obter mais informações, consulte os requisitos de tempo de execução do servidor do Gestor de Configuração.
Requisitos de desenvolvimento
Para obter mais informações, consulte os requisitos de desenvolvimento do servidor do Gestor de Configuração.
Ver também
SMS_CollectionRule server WMI class (Classe WMI de servidor SMS_CollectionRule)