Boîte de dialogue How to Create a Configuration Manager

Article
04/04/2023

Ces procédures vous montrent comment créer un assembly de boîte de dialogue sans mode, dans Configuration Manager, à l’aide de Visual Studio.

La création de la boîte de dialogue est très similaire à la création d’une feuille de propriétés. Vous créez une classe dérivée de SmsPageControl et un fichier XML pour décrire la boîte de dialogue.

Pour plus d’informations sur le gestionnaire de propriétés, consultez Utilisation des objets passés à un Configuration Manager Forms.

Une fois que vous avez correctement généré l’assembly de boîte de dialogue, vous devez effectuer les opérations suivantes pour l’intégrer à la console Configuration Manager :

Définissez et déployez le formulaire XML qui lie l’action sélectionnée à l’assembly que vous créez dans cette rubrique. Pour plus d’informations, consultez How to Create Form XML for a Configuration Manager Dialog Box.
Définissez et déployez l’action XML pour afficher le menu contextuel sélectionné par l’utilisateur. Pour plus d’informations, consultez How to Create Action XML for a Configuration Manager Dialog Box.

Une fois que vous avez créé l’assembly de boîte de dialogue et le code XML, cliquez avec le bouton droit sur un package dans le nœud Packages de l’arborescence de la console Configuration Manager, puis cliquez sur Afficher ma boîte de dialogue. Une boîte de dialogue s’affiche avec un bouton. Le fait de cliquer sur le bouton affiche une boîte de message contenant le nom du package que vous avez sélectionné.

Créer la classe de contrôle

La procédure suivante crée le contrôle pour la boîte de dialogue.

Pour créer le projet Visual Studio

Dans Visual Studio 2010, dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet pour ouvrir la boîte de dialogue Nouveau projet .
Dans la liste des projets Visual C#, Windows, sélectionnez le modèle de projet Bibliothèque de contrôles Windows , puis tapez ConfigMgrDialogControl dans la zone Nom .
Cliquez sur OK pour créer le projet Visual Studio.
Dans Explorateur de solutions, cliquez avec le bouton droit sur UserControl1.cs, cliquez sur Renommer, puis remplacez le nom par ConfigMgrDialogControl.cs.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence.
Dans la boîte de dialogue Ajouter une référence, cliquez sur l’onglet Parcourir, accédez à %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin, puis sélectionnez microsoft.configurationmanagement.exe, microsoft.configurationmanagement.managementprovider.dll, Microsoft.ConfigurationManagement.DialogFoundation.dll et AdminUI.DialogFoundation.dll. Cliquez sur OK pour ajouter les assemblys en tant que références de projet.
Dans Explorateur de solutions, cliquez avec le bouton droit sur ConfigMgrDialogControl.cs, puis cliquez sur Afficher le code.
Dans le code source, remplacez l’espace de noms par Microsoft.ConfigurationManagement.AdminConsole.ConfigMgrDialogBox
Modifiez la classe ConfigMgrDialogControl pour qu’elle dérive de SmsCustomDialog.
Dans Explorateur de solutions, cliquez avec le bouton droit sur ConfigMgrDialogControl.Designer.cs, puis cliquez sur Afficher le code.
Dans le code source, remplacez l’espace de noms par Microsoft.ConfigurationManagement.AdminConsole.ConfigMgrDialogBox
Modifiez la classe ConfigMgrDialogControl pour qu’elle dérive de SmsCustomDialog.

Dans ConfigMgrDialogControl.cs, ajoutez le code suivant pour initialiser le contrôle :

public override bool Initialize(System.Reflection.Assembly assembly, SmsFormData formData, SmsPageData pageData)  
{  
    base.Initialize(assembly, formData, pageData);  
    return true;  
}

Dans Explorateur de solutions, cliquez avec le bouton droit sur ConfigMgrDialogControl.cs et sélectionnez Concepteur de vues.
Dans la Boîte à outils, cliquez sur l’onglet Contrôles communs , puis double-cliquez sur Bouton. Un bouton nommé button1 est ajouté à votre contrôle sur le Concepteur de contrôles utilisateur.
Dans le Concepteur de contrôles utilisateur, double-cliquez sur button1 et tapez le code suivant dans le code source de la méthode button1_Click affiché :
```
MessageBox.Show( PageData.PropertyManager["Name"].StringValue);  
```

Déployer l’assembly

La procédure suivante génère et copie l’assembly que vous avez créé dans le dossier de console assemblies Configuration Manager. Pour plus d’informations sur le déploiement d’extensions de console Configuration Manager, consultez À propos de Configuration Manager déploiement d’extensions de console.

Pour déployer l’assembly de boîte de dialogue

Générez le projet et, selon l’emplacement où vous avez créé votre projet, votre installation Visual Studio, l’assembly est créé en tant que \Visual Studio 2010\Projects\ConfigMgDialogControl\ConfigMgrDialogControl\bin\Debug\ConfigMgrDialogControl.dll.
Copiez l’assembly dans le dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin.

Voir aussi

Guide pratique pour ajouter une page de propriétés à une feuille de propriétés Configuration Manager existante
Guide pratique pour créer un code XML d’action pour une feuille de propriétés Configuration Manager
Guide pratique pour créer un formulaire XML pour une feuille de propriétés Configuration Manager
Comment utiliser des objets passés à un Configuration Manager Forms

Partager via