Partager via


À propos des formulaires de console Configuration Manager

Vous pouvez étendre la console Configuration Manager avec de nouveaux Windows Forms. Plus précisément, vous pouvez ajouter des boîtes de dialogue basées sur des formulaires et des feuilles de propriétés. Un utilisateur accède à ces formulaires à partir de Configuration Manager actions que vous définissez.

Remarque

Les Assistants sont un autre formulaire Windows utilisé par la console Configuration Manager, mais vous ne pouvez pas étendre ou ajouter des Assistants à l’aide de l’infrastructure de console Configuration Manager. Toutefois, vous pouvez exécuter votre propre solution d’Assistant à l’aide d’actions Configuration Manager.

Dans Configuration Manager, les formulaires sont stockés dans des assemblys .NET Framework qui sont appelés par la console Configuration Manager une fois l’action appropriée sélectionnée.

Création d’un formulaire d’extension

Pour écrire un formulaire d’extension, procédez comme suit :

  • Créez l’assembly de formulaire d’extension.

  • Créez le code XML de l’action de formulaire d’extension.

  • Créez le format XML du formulaire d’extension.

Créer l’assembly de formulaire d’extension

Feuilles de propriétés

Une feuille de propriétés est composée d’une ou plusieurs pages de propriétés que vous définissez. Vous pouvez également intégrer des pages de propriétés dans des feuilles de propriétés Configuration Manager existantes.

Pour créer une feuille de propriétés, vous créez un projet bibliothèque de contrôles Windows dans Visual Studio. Dans ce projet, vous créez une classe qui hérite du Microsoft. Classe ConfigurationManagement.AdminConsole.SmsPageControl. Cette classe implémente le contrôle que vous souhaitez afficher sur une page de propriétés. Dans une feuille de propriétés, vous créez une classe SmsPageControl pour chaque page de propriétés dont vous avez besoin. L’exemple prototype de feuille de propriétés dans le Kit de développement logiciel (SDK) Configuration Manager propose une solution complète que vous pouvez utiliser. Pour plus d’informations, consultez How to Create a Configuration Manager Property Sheet.

Boîtes de dialogue

Une boîte de dialogue dans Configuration Manager s’affiche comme une boîte de dialogue sans mode classique. Vous créez un SMSPageControl et spécifiez « Dialog » dans form XML. Pour plus d’informations, consultez How to Create a Configuration Manager Dialog Box.

Créer le code XML de l’action de formulaire

Une action décrit le type d’extension appelé et l’emplacement où l’action est placée dans l’interface utilisateur de la console Configuration Manager. Pour un formulaire d’extension, vous utilisez le ShowDialog type d’action pour afficher le formulaire. Pour plus d’informations, consultez How to Create Action XML for a Configuration Manager Property Sheet.

Pour plus d’informations sur les actions, consultez À propos des actions Configuration Manager console.

Créer le fichier XML de feuille de propriétés du formulaire

Que le formulaire soit une feuille de propriétés ou non, le formulaire comporte un fichier XML de formulaire qui définit l’assembly, l’espace de noms et le type du formulaire. Dans les feuilles de propriétés, il définit l’ordre des pages de propriétés sur la feuille de propriétés. Il existe un fichier XML de feuille de propriétés pour chaque formulaire de console Configuration Manager.

Remarque

Les fichiers XML de feuille de propriétés Configuration Manager console sont stockés dans %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms.

Lorsque vous créez un formulaire, vous créez un fichier XML de feuille de propriétés. Si vous ajoutez une nouvelle page de propriétés à une feuille de propriétés existante, vous fusionnez le code XML de la page de propriétés avec un fichier XML de feuille de propriétés existant.

Remarque

Les feuilles de propriétés d’extension sont stockées dans %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Pour plus d’informations sur le déploiement xml de formulaire, consultez déploiement d’extension de console Configuration Manager.

Selon que vous affichez une boîte de dialogue ou une feuille de propriétés, les valeurs de l’attribut FormType doivent être définies.

FormType Description
Feuille de propriétés Le formulaire est une feuille de propriétés.
Boîte de dialogue Le formulaire est une boîte de dialogue.

Lorsqu’une action est sélectionnée, la console Configuration Manager utilise le xml de feuille de propriétés pour déterminer l’assembly nécessaire pour charger et afficher le formulaire.

Pour plus d’informations, consultez How to Create Form XML for a Configuration Manager Property Sheet.

Gestion des données d’objet dans un formulaire

Un formulaire Configuration Manager peut être transmis des données personnalisées et également, à partir du volet de résultats, les objets retournés à partir d’une requête. Les objets sélectionnés dans le volet de résultats sont mis à disposition d’un formulaire via un objet PropertyManager . Pour plus d’informations, consultez Guide pratique pour utiliser des objets passés à un formulaire Configuration Manager. Vous pouvez lier un contrôle de formulaire à des objets passés au du PropertyManagerformulaire. Pour plus d’informations, consultez Guide pratique pour lier des données Configuration Manager à un formulaire.

La console Configuration Manager sérialise Configuration Manager objets passés dans un formulaire lorsque le formulaire est ignoré.

Requêtes

Vous pouvez effectuer des requêtes synchrones et asynchrones dans des formulaires à l’aide du fournisseur SMS managé. Tu as la Microsoft. Objet ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor du formulairePropertyManager. Une fois obtenu, le code est identique aux exemples de fournisseur SMS. Pour obtenir un exemple de requête synchrone, consultez How to Perform a Synchronous Configuration Manager Query by Using Managed Code.

Pour obtenir un exemple de requête asynchrone, consultez How to Perform an Asynchrone Configuration Manager Query by Using Managed Code.

Voir aussi

Guide pratique pour ajouter une page de propriétés à une feuille de propriétés Configuration Manager existante
Comment lier des données Configuration Manager à un formulaire
Comment créer une feuille de propriétés Configuration Manager
Guide pratique pour créer un code XML d’action pour une boîte de dialogue Configuration Manager
Guide pratique pour créer un code XML d’action pour une feuille de propriétés Configuration Manager
Boîte de dialogue How to Create a Configuration Manager
Guide pratique pour créer un fichier XML de formulaire pour une boîte de dialogue Configuration Manager
Guide pratique pour créer un formulaire XML pour une feuille de propriétés Configuration Manager
Utilisation des objets passés à un formulaire Configuration Manager