Como criar um controle de ação personalizado Configuration Manager

Artigo
04/04/2023

Em Configuration Manager, para criar um controle de ação personalizado, você cria um controle do Windows usando as duas classes a seguir:

Classe	Descrição
SmsOsdEditorPageControl	O controle de ação personalizado. Você deriva dessa classe para implementar o controle de ação personalizado exibido no Editor de Sequência de Tarefas.
TaskSequenceOptionControl	O controle de opções para a ação personalizada. Você deriva dessa classe para criar a página de opções de ação personalizada que é exibida no Editor de Sequência de Tarefas.

Esses procedimentos mostram como criar um assembly de controle de implantação do sistema operacional Configuration Manager usando o Visual Studio 2005. Quando ele é carregado no Editor de Sequência de Tarefas, o controle exibe uma página de propriedade que contém uma caixa de texto usada para definir uma variável de ação nome de usuário para a ação personalizada.

Depois de concluir essas etapas, execute as etapas nos tópicos a seguir para criar o arquivo MOF (formato de objeto gerenciado por ação) personalizado e usar o controle de ação personalizado.

Como criar um arquivo MOF para uma ação personalizada Configuration Manager

Como usar uma ação personalizada Configuration Manager

Observação

Para obter informações sobre como usar a ação personalizada como parte de uma implantação, consulte Sobre Configuration Manager aplicativos cliente de ação personalizada

O Projeto do Control Visual Studio

O procedimento a seguir cria o projeto de controle de ação personalizado.

Criar o controle

No Visual Studio 2010, no menu Arquivo , aponte para Novo e clique em Projeto para abrir a caixa de diálogo Novo Projeto .
Na lista do Visual C#, projetos do Windows , selecione o modelo de projeto da Biblioteca de Controle do Windows e digite ConfigMgrTSAction na caixa Nome .
Clique em OK para criar o projeto do Visual Studio.
Em Gerenciador de Soluções, clique com o botão direito do mouse em UserControl1.cs, clique em Renomear e altere o nome para ConfigMgrTSActionControl.cs.
No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e clique em Adicionar Referência.
Na caixa de diálogo Adicionar Referência, clique na guia Procurar, navegue até %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin e selecione os seguintes assemblies:
- Adminui.osdcommon.dll
- Adminui.tasksequenceeditor.dll
- Adminui.wqlqueryengine.dll
- Microsoft.configurationmanagement.exe
- Microsoft.configurationmanagement.managementprovider.dll
Clique em OK para adicionar os assemblies como referências de projeto.
Em Gerenciador de Soluções, clique com o botão direito do mouse em ConfigMgrTSActionControl.cs e clique em Exibir Código.

Adicione o seguinte código para incluir os namespaces necessários:

using Microsoft.ConfigurationManagement.AdminConsole;  
using Microsoft.ConfigurationManagement.AdminConsole.TaskSequenceEditor;

Altere a classe ConfigMgrTSActionControl para que ela seja derivada de SmsOsdEditorPageControl.

Em ConfigMgrTSActionControl.cs, adicione o seguinte novo construtor à classe ConfigMgrTSActionControl :

public ConfigMgrTSActionControl(SmsPageData data) : base(data)   
{   
    InitializeComponent();   
}

Adicione o seguinte método para inicializar o controle:

public override void InitializePageControl()  
{  
   base.InitializePageControl();  
}

Criar um controle de opções

O procedimento a seguir cria o código que declara o controle de opções para a ação personalizada. Essa implementação usa o controle de opções padrão.

Para criar um controle de opções

No final de ConfigMgrTSActionControl.cs , adicione a seguinte nova classe no namespace ConfigMgrTSAction :

public class ConfigureTSActionOptions : TaskSequenceOptionControl  
{  
    public ConfigureTSActionOptions() : base()   
    {  
    }  
    public ConfigureTSActionOptions(SmsPageData data) : base(data)   
    {  
    }  
}

Personalizar a Interface do Usuário

O procedimento a seguir adiciona uma caixa de texto e um código para gerenciar dados de ação.

Para adicionar a interface do usuário

Em Gerenciador de Soluções, clique com o botão direito do mouse em ConfigMgrTSActionControl.cs e clique em Exibir Designer.
Na caixa de ferramentas, clique na guia Controles Comuns e clique duas vezes em TextBox. Um botão chamado textBox1 é adicionado ao seu controle no Designer de Controle de Usuário.
Clique duas vezes na caixa de texto. Um manipulador de eventos chamado textBox1_TextChanged é adicionado à classe ConfigMgrTSActionControl. Adicione o seguinte código para garantir que as alterações sejam salvas no gerenciador de propriedades da ação:
```
SetDirtyFlag(true);  
```

Na classe ConfigMgrTSActionControl, adicione o método a seguir para gravar o valor da caixa de texto à User propriedade definida na ação personalizada MOF. Isso é chamado quando o botão OK ou Apply é clicado.

protected override bool ApplyChanges(out Control errorControl, out bool showError)  
{  
    // You can check the error here and return false.  
    if (this.HasError(out errorControl) == true)  
    {  
        this.ShowMessageBox(  
            this.GetErrorString(),  
            "Error",  
            MessageBoxButtons.OK,  
            MessageBoxIcon.Warning);  
        errorControl = null;  
        showError = true;  
        return false;  
    }  
    this.PropertyManager["User"].StringValue = textBox1.Text;  

    return base.ApplyChanges(out errorControl, out showError);  
}

Na exibição de design do controle, clique duas vezes no controle para criar o método ConfigMgrTSActionControl_Load.
Adicione o código a seguir ao método. Esse código carrega a caixa de texto com um valor de usuário existente. Isso acontece quando a ação de sequência de tarefas é editada após a criação.
```
textBox1.Text = this.PropertyManager["User"].StringValue;  
```

Cadeias de Caracteres de Recurso

O procedimento a seguir adiciona as cadeias de caracteres de recurso usadas para exibir o nome da ação personalizada no Editor de Sequência de Tarefas.

Para adicionar cadeias de caracteres de recurso

Em Gerenciador de Soluções, no menu Projeto, clique em Propriedades.
Clique na guia Recursos . Se o arquivo de recursos não existir, crie-o selecionando a mensagem exibida na guia Recursos .
Na barra de ferramentas do Designer de Recursos, aponte para a lista suspensa do modo de exibição de recursos, clique na seta e verifique se ela está definida como Cadeias de Caracteres (que é o padrão). Uma grade de configurações é exibida, exibindo as cadeias de caracteres mantidas por essa instância do Designer de Recursos.
Clique na coluna Nome da última linha na grade, que é marcada com um asterisco (*).
Na coluna Nome , insira DefaultDisplay_ConfigMgrTSAction como o nome da cadeia de caracteres.
Na coluna Valor , insira a cadeia de caracteres Ação Personalizada. Essa é a cadeia de caracteres exibida na lista de ações de sequência de tarefas.
Clique na coluna Nome da última linha na grade, que é marcada com um asterisco (*).
Na coluna Nome , insira ConfigMgrTSAction como o nome da cadeia de caracteres.
Na coluna Valor , insira Custom Action. Essa é a cadeia de caracteres exibida quando você adiciona a ação personalizada.

Implantar o Assembly

Esse procedimento cria e copia o assembly que você criou para a pasta Configuration Manager assemblies de console. Para obter informações importantes sobre como implantar extensões de console Configuration Manager, consulte Sobre Configuration Manager Implantação de Extensão de Console do Administrador.

Para implantar o assembly

Compile o projeto. O Visual Studio cria o assembly como \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll.
Copie o assembly para a pasta %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin.

Confira também

Sobre Configuration Manager Extensão do Console
Implantação da extensão do console Configuration Manager
Como criar um arquivo MOF para uma ação personalizada Configuration Manager
Como usar uma ação personalizada Configuration Manager

Compartilhar via