Criar uma coleção Dinâmica - Configuration Manager | Microsoft Docs
Como criar uma coleção dinâmica
No Configuration Manager, seu aplicativo usa a classe WMI do SMS_Collection Server para definir os atributos de uma coleção, como as regras de associação e o cronograma de atualização. A propriedade contém o nome de classe MemberClassName gerado pelo sistema que contém os membros da coleção.
Os membros de uma coleção são especificados usando regras diretas, regras de consulta ou ambos. As regras diretas definem um recurso explícito, enquanto as regras de consulta definem uma coleção dinâmica que é avaliada regularmente com base no estado atual do site.
Ao criar uma regra de associação direta, lembre-se de que a regra sempre deve ter o mesmo nome que o computador especificado pela regra.
Seu aplicativo usa a classe SMS_CollectionRuleQuery Server WMI para definir regras de consulta. A consulta deve ser válida e pode especificar a coleção para conter recursos como "Todos os usuários no domínio corporativo". Em seguida, o aplicativo pode usar a consulta para garantir que um programa seja direcionado para distribuição de software para todos os computadores que atendem aos critérios. À medida que o site muda e o conjunto é reavaliado, os membros da coleção são adicionados e excluídos automaticamente.
Ao executar uma consulta em uma coleção dinâmica, verifique se o Provedor de SMS está carregado ou se outro método ou consulta já foi executado.
As coleções estão intimamente vinculadas a pacotes, programas e anúncios. Para obter mais informações, consulte Visão geral da distribuição de software.
Estes exemplos exigem os seguintes valores:
Um Windows de conexão WMI (Instrumentação de Gerenciamento).
Um novo nome de coleção dinâmica.
Um novo comentário de coleção dinâmica.
O sinalizador "propriedade deste site".
Uma consulta (cadeia de caracteres).
Um nome de regra estático.
Um identificador de coleção para limitar o escopo da associação.
Se a coleção Todos os Sistemas (SMS00001) tiver sido removida do servidor do site, o exemplo VBScript não funcionará.
Exemplo da chamada de sub-rotina no Visual Basic:
Exemplo da chamada de método em C#:
Para criar uma coleção dinâmica
Configurar uma conexão com o Provedor de SMS. Para obter mais informações, consulte Fundamentos básicos do Provedor de SMS.
Crie o novo objeto de coleção usando a classe WMI SMS_Collection Server.
Crie a regra usando a classe WMI SMS_CollectionRuleQuery Server.
Adicione a regra à coleção.
Atualize a coleção.
O método de exemplo a seguir cria uma coleção dinâmica usando SMS_Collection Classe WMI do Servidor e as classes e as propriedades de classe WMI do servidor SMS_CollectionRuleQuery Server.
connection - Gerenciado: WqlConnectionManager
- VBScript: SWbemServices Uma conexão válida com o Provedor de SMS.
newCollectionName - Gerenciado: String
- VBScript: String O nome exclusivo que representa a coleção no console do Configuration Manager.
newCollectionComment - Gerenciado: String
- VBScript: String Comentário geral ou observação que documenta a coleção.
ownedByThisSite - Gerenciado: Boolean
- VBScript: Boolean true se a coleção se originou no site do Configuration Manager local.
query - Gerenciado: String
- VBScript: String Instrução SELECT WQL com resultados que são usados para preencher a coleção. A instrução deve especificar um nome de classe de recurso.
ruleName - Gerenciado: String
- VBScript: String Nome descritivo que identifica a regra.
limitToCollectionID - Gerenciado: String
- VBScript: String Identificador de coleção para limitar o escopo da associação.
O C# exemplo exige:
Para obter mais informações sobre o tratamento de erros, consulte About Configuration Manager Errors.
Para obter mais informações sobre como proteger aplicativos do Configuration Manager, consulte Configuration Manager role-based administration.
Visão geral de distribuição de software Sobre implantações Visão geral dos objetos Como Conexão para um provedor de SMS no Gerenciador de Configurações usando código gerenciado