Sobre Configuration Manager Console Forms

Você pode estender o console Configuration Manager com novos formulários do Windows. Especificamente, você pode adicionar caixas de diálogo baseadas em formulário e planilhas de propriedades. Um usuário acessa esses formulários de Configuration Manager ações que você define.

Observação

Os assistentes são outro formulário do Windows que é usado pelo console Configuration Manager, mas você não pode estender ou adicionar assistentes usando a estrutura de console Configuration Manager. No entanto, você pode executar sua própria solução de assistente usando Configuration Manager ações.

Em Configuration Manager, os formulários são armazenados em .NET Framework assemblies que são chamados pelo console Configuration Manager depois que a ação apropriada é selecionada.

Criando um formulário de extensão

Para gravar um formulário de extensão, você faz o seguinte:

  • Crie o assembly de formulário de extensão.

  • Crie a ação de formulário de extensão XML.

  • Crie o formulário de extensão XML.

Criar o Assembly de Formulário de Extensão

Planilhas de propriedades

Uma folha de propriedades é composta por uma ou mais páginas de propriedade que você define. Você também pode integrar páginas de propriedades em planilhas de propriedades Configuration Manager existentes.

Para criar uma planilha de propriedades, crie um projeto da Biblioteca de Controle do Windows no Visual Studio. Neste projeto, você cria uma classe que herda do Microsoft. Classe ConfigurationManagement.AdminConsole.SmsPageControl. Essa classe implementa o controle que você deseja exibir em uma página de propriedade. Em uma folha de propriedades, você cria uma classe SmsPageControl para cada página de propriedade de que precisa. O exemplo de Protótipo de Planilha de Propriedades no SDK Configuration Manager tem uma solução completa que você pode usar. Para obter mais informações, consulte Como criar uma folha de propriedades Configuration Manager.

Caixas de diálogo

Uma caixa de diálogo no Configuration Manager é exibida como uma caixa de diálogo modeless típica. Crie um SMSPageControl e especifique "Caixa de Diálogo" no Formulário XML. Para obter mais informações, consulte Como criar uma caixa de diálogo Configuration Manager.

Criar o XML da Ação de Formulário

Uma ação descreve o tipo de extensão chamada e onde a ação é colocada na interface do usuário do console Configuration Manager. Para um formulário de extensão, você usa o ShowDialog tipo de ação para exibir o formulário. Para obter mais informações, consulte Como criar a Ação XML para uma folha de propriedades Configuration Manager.

Para obter mais informações sobre ações, consulte Sobre Configuration Manager ações de console.

Criar a folha de propriedades de formulário XML

Se o formulário é ou não uma folha de propriedades, o formulário tem um arquivo XML de formulário que define o assembly, o namespace e o tipo do formulário. Em planilhas de propriedades, ele define a ordem das páginas da propriedade na folha de propriedades. Há um arquivo XML da folha de propriedades para cada formulário de console Configuration Manager.

Observação

Os arquivos XML da folha de propriedades do console Configuration Manager são armazenados em %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms.

Ao criar um novo formulário, você cria um novo arquivo XML da folha de propriedades. Se você estiver adicionando uma nova página de propriedade a uma folha de propriedades existente, mescla a página de propriedade XML com um arquivo XML da folha de propriedades existente.

Observação

As planilhas de propriedades de extensão são armazenadas em %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Para obter mais informações sobre a implantação do formulário XML, consulte Configuration Manager Implantação de Extensão do Console.

Dependendo se você estiver exibindo uma caixa de diálogo ou uma folha de propriedades, os valores do atributo FormType devem ser definidos.

FormType Descrição
Propertysheet O formulário é uma folha de propriedades.
Diálogo O formulário é uma caixa de diálogo.

Quando uma ação é selecionada, o console Configuration Manager usa a folha de propriedades XML para determinar qual assembly é necessário para carregar e exibir o formulário.

Para obter mais informações, consulte Como criar o Formulário XML para uma folha de propriedades Configuration Manager.

Gerenciando dados de objeto em um formulário

Um formulário Configuration Manager pode ser passado dados personalizados e, também, no painel de resultados, os objetos retornados de uma consulta. Objetos selecionados no painel de resultados são disponibilizados para um formulário por meio de um objeto PropertyManager . Para obter mais informações, consulte Como usar objetos passados para um formulário de Configuration Manager. Você pode associar um controle de formulário a objetos passados para o formulário PropertyManager. Para obter mais informações, consulte Como associar dados de Configuration Manager a um formulário.

O console Configuration Manager serializa Configuration Manager objetos passados para um formulário quando o formulário é descartado.

Consultas

Você pode executar consultas síncronas e assíncronas em formulários usando o provedor de SMS gerenciado. Você obtém o Microsoft. Objeto ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor do connectionManager do PropertyManager formulário. Depois que ele é obtido, o código é idêntico aos exemplos do Provedor de SMS. Para obter um exemplo de uma consulta síncrona, consulte Como executar uma consulta de Configuration Manager síncrona usando código gerenciado.

Para obter um exemplo de uma consulta assíncrona, consulte Como executar uma consulta assíncrona Configuration Manager usando código gerenciado.

Confira também

Como adicionar uma página de propriedade a uma folha de propriedades Configuration Manager existente
Como associar dados Configuration Manager a um formulário
Como criar uma folha de propriedades Configuration Manager
Como criar o XML de ação para uma caixa de diálogo Configuration Manager
Como criar o XML de ação para uma folha de propriedades Configuration Manager
Como criar uma caixa de diálogo Configuration Manager
Como criar xml de formulário para uma caixa de diálogo Configuration Manager
Como criar xml de formulário para uma folha de propriedades Configuration Manager
Como usar objetos passados para um formulário de Configuration Manager