Déploiement de l’extension de console Configuration Manager

Article
04/04/2023

Le déploiement d’une extension Configuration Manager classique doit prendre en compte les actions, les formulaires, les vues, les classes de gestion et les extensions de nœud.

Lorsque vous déployez une extension Configuration Manager, vous installez les fichiers dans les répertoires suivants :

Type d’extension	Répertoire
Actions	%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin pour l’assembly %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Actions pour les fichiers XML d’action
Formulaires	%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin pour l’assembly %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms pour les fichiers XML de formulaire
Affichages	%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\bin pour l’assembly
Nodes	%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin pour l’assembly %ProgramFiles%Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes pour les fichiers XML du nœud
ManagementClasses	%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin pour l’assembly %ProgramFiles%Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses pour les fichiers XML des classes de gestion

Importante

Le fait de placer vos assemblys et dépendances dans le dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin peut créer des conflits avec d’autres extensions de console et empêcher le chargement de votre extension.

Vous devez également effectuer les tâches suivantes lors de l’installation et de la désinstallation des actions.

Actions personnalisées

Installation d’une action personnalisée

Pour installer un fichier XML d’action personnalisée, copiez le fichier dans le dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Actions\<GUID>, où <GUID> est l’identificateur GUID du nœud auquel l’action s’applique.

Suppression d’une action personnalisée

Pour supprimer une action personnalisée, supprimez le fichier XML d’action personnalisée. S’il n’y a pas d’autres fichiers XML dans le dossier, il est sûr de supprimer le dossier.

Formulaires

Installation d’un formulaire

Vous copiez l’assembly de formulaire dans %ProgramFiles%\ Microsoft Endpoint Manager\AdminConsole\bin ou dans le dossier d’installation de votre application.

Si vous effectuez un déploiement dans un répertoire autre que le dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin, l’attribut XML<Assembly> de formulaire, Name, doit inclure le nom de fichier de l’assembly et le chemin d’accès complet au fichier. Pour plus d’informations, consultez How to Create Form XML for a Configuration Manager Property Sheet.

Pour installer un fichier XML de feuille de propriétés d’extension pour un formulaire, copiez le fichier dans le dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms. Étant donné que tous les formulaires d’extension sont placés dans ce dossier, vous devez vous assurer que votre fichier XML a un nom unique. Il est suggéré d’utiliser le nom de votre société dans le cadre du nom de fichier.

Si le formulaire est une extension d’une feuille de propriétés existante, vous devez déterminer si la feuille de propriétés existe déjà dans le dossier Extensions\Forms, puis ajouter votre page de propriétés à cette feuille de propriétés.

Lorsque la console Configuration Manager se charge, elle charge les feuilles de propriétés dans le dossier Extensions\Forms de préférence sur les feuilles de propriétés existantes.

Vous devez utiliser l’attribut VendorId de l’élément Page , car cela permet à d’autres fournisseurs d’identifier et d’éviter de modifier vos extensions.

Suppression d’un formulaire

Pour supprimer un formulaire qui n’étend pas une feuille de propriétés existante, supprimez le fichier XML de la feuille de propriétés du dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Pour supprimer une page de propriétés que vous avez ajoutée à une feuille de propriétés existante, vous devez effectuer les actions suivantes avec la feuille de propriétés :

Consultez les pages de propriétés des Id de fournisseur autres que Microsoft Corporation. S’il n’en existe aucun, il est possible de supprimer le fichier XML de la feuille de propriétés du dossier Extensions\Forms.
S’il existe d’autres VendorID, supprimez le code XML de votre page de propriétés de la feuille de propriétés et laissez la feuille de propriétés dans le dossier Extensions\Forms.

Affichages

Installation d’une vue

Pour installer une vue, copiez l’assembly d’affichage dans le dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin ou dans le dossier d’installation de votre application.

Si vous effectuez un déploiement dans un dossier autre que %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin, l’élément XML<Assembly> du nœud doit inclure le nom de fichier de l’assembly et le chemin d’accès complet au fichier. Pour plus d’informations, consultez How to Create Node XML for a Configuration Manager Console View.

Vous devez également copier le code XML du nœud qui intègre la vue dans la console Configuration Manager dans le dossier> %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID, où <GUID> est l’identificateur GUID du nœud auquel l’action s’applique. Pour plus d’informations, consultez la section « Nœuds » plus loin dans cette rubrique.

Suppression d’une vue

Pour supprimer une vue, supprimez l’assembly d’affichage du dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin. Vous devez vous assurer qu’aucune autre extension ne fait référence à la vue avant de la supprimer. Vous devez également supprimer le fichier XML de nœud de la vue du dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID>, où <GUID> est l’identificateur GUID du nœud auquel l’action s’applique.

Classes de gestion personnalisées

Installation d’une classe de gestion personnalisée

Copiez l’assembly de classe de gestion dans %ProgramFiles%\ Microsoft Endpoint Manager\AdminConsole\bin ou dans le dossier d’installation de votre application.

Pour installer un fichier XML de classe de gestion personnalisée, copiez le fichier dans le dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses. Étant donné que toutes les classes de gestion personnalisées sont placées dans ce dossier, vous devez vous assurer que votre fichier XML a un nom unique. Il est suggéré d’utiliser le nom de votre société dans le cadre du nom de fichier.

Suppression d’une classe de gestion personnalisée

Pour supprimer une classe de gestion personnalisée, supprimez le fichier XML de la classe de gestion personnalisée. S’il n’y a pas d’autres fichiers XML dans le dossier, il est sûr de supprimer le dossier.

Nodes

Installation d’un nœud

Pour installer un nœud, créez un dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> , où <GUID> est l’identificateur GUID du nœud parent de la console Configuration Manager. Copiez le fichier XML du nœud dans le dossier GUID. Pour plus d’informations, consultez À propos des nœuds de console.

Suppression d’un nœud

Pour supprimer un nœud, supprimez le fichier XML du nœud du dossier %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID>.

Voir aussi

À propos de l’extension de console Configuration Manager
À propos des actions Configuration Manager console À propos des formulaires de console À propos des classes de gestion de console À propos des nœuds de console À propos des vues de console

Partager via