Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez étendre la console de Configuration Manager avec de nouveaux formulaires Windows. Vous pouvez en particulier ajouter des boîtes de dialogue et des feuilles de propriétés basées sur des formulaires. Un utilisateur accède à ces formulaires à partir des actions du Configuration Manager que vous définissez.
Remarque
Les Assistants sont un autre formulaire Windows utilisé par la console du Configuration Manager, mais vous ne pouvez pas étendre ou ajouter des Assistants à l’aide de l’infrastructure de la console du Configuration Manager. Vous pouvez toutefois exécuter votre propre solution d’Assistant à l’aide des actions du Configuration Manager.
Dans le Configuration Manager, les formulaires sont stockés dans des assemblys .NET Framework appelés par la console du Configuration Manager une fois que l’action appropriée est sélectionnée.
Création d’un formulaire d’extension
Pour écrire un formulaire d’extension, procédez comme suit :
Création de l’assembly de formulaire d’extension.
Créez le code XML d’action de formulaire d’extension.
Créez le formulaire d’extension XML.
Création de l’assemblage de formulaire d’extension
Feuilles de propriétés
Une feuille de propriétés est constitué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 existantes du Configuration Manager.
Pour créer une feuille de propriétés, vous devez créer un projet Bibliothèque de contrôles Windows dans Visual Studio. Dans ce projet, vous créez une classe qui hérite de la classe Microsoft.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é dont vous avez besoin. L’exemple de prototype de feuille de propriétés du Kit de développement logiciel (SDK) Configuration Manager offre une solution complète que vous pouvez utiliser. Pour plus d’informations, voir Comment créer une feuille de propriétés pour le Configuration Manager.
Boîtes de dialogue
Une boîte de dialogue dans Configuration Manager s’affiche comme une boîte de dialogue non modale classique. Vous créez un SMSPageControl et spécifiez « Dialog » dans le XML du formulaire. Pour plus d’informations, voir Comment créer une boîte de dialogue Configuration Manager.
Créer le fichier XML d’action de formulaire
Une action décrit le type d’extension qui est appelée et où elle est placée dans l’interface utilisateur de la console de Configuration Manager. Dans le cas d’un formulaire d’extension, vous utilisez le type d’action ShowDialog pour afficher le formulaire. Pour plus d’informations, voir Comment créer un fichier XML d’action pour une feuille de propriétés de Configuration Manager.
Pour plus d’informations sur les actions, consultez À propos des actions de console de Configuration Manager.
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, il contient un fichier XML 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. Chaque formulaire de console du Configuration Manager contient un fichier XML de feuille de propriétés.
Remarque
Les fichiers XML de feuille de propriétés de la console du Configuration Manager 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 fichier 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 de formulaires XML, voir Déploiement d’extensions de console de Configuration Manager.
Selon que vous affichez une boîte de dialogue ou une feuille de propriétés, les valeurs d’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 du Configuration Manager utilise le fichier XML de la feuille de propriétés pour déterminer l’assembly nécessaire pour charger et afficher le formulaire.
Gestion des données d’objet dans un formulaire
Un formulaire Configuration Manager peut recevoir des données personnalisées, ainsi que, à partir du volet des résultats, les objets retournés à partir d’une requête. Les objets sélectionnés du volet Résultats sont accessibles dans un formulaire via un objet PropertyManager . Pour plus d’informations, voir Utilisation des objets transmis à un formulaire Configuration Manager. Vous pouvez lier un contrôle de formulaire à des objets transmis au fichier PropertyManager. Pour plus d’informations, voir Comment lier des données de Configuration Manager à un formulaire.
La console Configuration Manager sérialise les objets Configuration Manager transmis dans un formulaire lorsque le formulaire est masqué.
Requêtes
Vous pouvez effectuer des requêtes synchrones et asynchrones dans les formulaires à l’aide du fournisseur SMS géré. Vous obtenez l’objet Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor à partir du ConnectionManager du PropertyManager formulaire. Une fois obtenu, le code est identique aux exemples du fournisseur SMS. Pour obtenir un exemple de requête synchrone, consultez Procédure d’exécution d’une requête synchrone du Configuration Manager à l’aide de code managé.
Pour obtenir un exemple de requête asynchrone, consultez Procédure d’exécution d’une requête Configuration Manager asynchrone à l’aide de code managé.
Voir aussi
Comment ajouter une page de propriétés à une feuille de propriétés du Configuration Manager existanteProcédure pour lier des données de Configuration Manager à un formulaireProcédure pour créer une feuille de propriétés du Configuration ManagerComment créer un fichier XML d’action pour un Configuration Manager Boîte de dialogueComment créer un fichier XML d’action pour une feuille de propriétés de Configuration ManagerProcédure pour créer une boîte de dialogue du Configuration ManagerComment créer un formulaire XML pour une boîte de dialogue Configuration Manager Comment créer un formulaire XML pour un Feuille de propriétés de Configuration ManagerComment utiliser les objets transmis à un formulaire Configuration Manager