Bereitstellung der Configuration Manager-Konsolenerweiterung

  • Artikel

Bei der Bereitstellung einer typischen Configuration Manager-Erweiterung müssen Aktionen, Formulare, Sichten, Verwaltungsklassen und Knotenerweiterungen berücksichtigt werden.

Wenn Sie eine Configuration Manager-Erweiterung bereitstellen, installieren Sie die Dateien in den folgenden Verzeichnissen:

Erweiterungstyp Verzeichnis
Aktionen %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin für die Assembly

%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Actions für die XML-Dateien der Aktion
Formulare %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin für die Assembly

%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms für die XML-Formulardateien
Ansichten %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\bin für die Assembly
Nodes %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin für die Assembly

%ProgramFiles%Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes für die KNOTEN-XML-Dateien
ManagementClasses %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin für die Assembly

%ProgramFiles%Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses für die XML-Dateien der Verwaltungsklassen

Wichtig

Wenn Sie Ihre Assemblys und Abhängigkeiten im Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin platzieren, kann dies zu Konflikten mit anderen Konsolenerweiterungen führen und verhindern, dass Ihre Erweiterung geladen wird.

Sie müssen auch die folgenden Aufgaben während der Installation und Deinstallation von Aktionen ausführen.

Benutzerdefinierte Aktionen

Installieren einer benutzerdefinierten Aktion

Um eine XML-Datei für benutzerdefinierte Aktionen zu installieren, kopieren Sie die Datei in den Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Actions\<GUID>, wobei <GUID> der GUID-Bezeichner für den Knoten ist, auf den die Aktion angewendet wird.

Entfernen einer benutzerdefinierten Aktion

Um eine benutzerdefinierte Aktion zu entfernen, löschen Sie die XML-Datei für benutzerdefinierte Aktionen. Wenn der Ordner keine anderen XML-Dateien enthält, kann der Ordner sicher entfernt werden.

Formulare

Installieren eines Formulars

Sie kopieren die Formularassembly entweder in %ProgramFiles%\ Microsoft Endpoint Manager\AdminConsole\bin oder in den Installationsordner Ihrer Anwendung.

Wenn Sie die Bereitstellung in einem anderen Verzeichnis als dem Ordner "%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin" durchführen, sollte das XML-Formular-Attribut<Assembly>Nameden Namen der Assemblydatei und den vollständigen Pfad zur Datei enthalten. Weitere Informationen finden Sie unter How to Create Form XML for a Configuration Manager Property Sheet.For more information, see How to Create Form XML for a Configuration Manager Property Sheet.

Um eine XML-Datei des Erweiterungseigenschaftenblatts für ein Formular zu installieren, kopieren Sie die Datei in den Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms. Da sich alle Erweiterungsformulare in diesem Ordner befinden, müssen Sie sicherstellen, dass Ihre XML-Datei einen eindeutigen Namen hat. Es wird empfohlen, ihren Firmennamen als Teil des Dateinamens zu verwenden.

Wenn das Formular eine Erweiterung eines vorhandenen Eigenschaftenblatts ist, müssen Sie ermitteln, ob das Eigenschaftenblatt bereits im Ordner Extensions\Forms vorhanden ist, und dann die Eigenschaftenseite zu diesem Eigenschaftenblatt hinzufügen.

Wenn die Configuration Manager-Konsole geladen wird, werden Eigenschaftenblätter im Ordner Extensions\Forms vor vorhandenen Eigenschaftenblättern geladen.

Sie sollten das VendorId -Attribut des Page -Elements verwenden, da dies anderen Anbietern ermöglicht, Ihre Erweiterungen zu identifizieren und zu vermeiden.

Entfernen eines Formulars

Um ein Formular zu entfernen, das kein vorhandenes Eigenschaftenblatt erweitert, entfernen Sie die XML-Datei des Eigenschaftenblatts aus dem Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Um eine Eigenschaftenseite zu entfernen, die Sie einem vorhandenen Eigenschaftenblatt hinzugefügt haben, müssen Sie die folgenden Aktionen mit dem Eigenschaftenblatt ausführen:

  • Überprüfen Sie die Eigenschaftenseiten auf andere VendorIDs als Microsoft Corporation. Wenn keine vorhanden ist, ist es sicher, die XML-Datei des Eigenschaftenblatts aus dem Ordner Extensions\Forms zu löschen.

  • Wenn andere VendorIDs vorhanden sind, entfernen Sie die XML-Datei der Eigenschaftenseite aus dem Eigenschaftenblatt, und belassen Sie das Eigenschaftenblatt im Ordner Extensions\Forms.

Ansichten

Installieren einer Ansicht

Kopieren Sie zum Installieren einer Ansicht die Ansichtsassembly in den Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin oder in den Installationsordner Ihrer Anwendung.

Wenn Sie die Bereitstellung in einem anderen Ordner als %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin durchführen, sollte das KNOTEN-XML-Element<Assembly> den Dateinamen der Assembly und den vollständigen Pfad zur Datei enthalten. Weitere Informationen finden Sie unter Erstellen von Knoten-XML für eine Configuration Manager Konsolenansicht.

Außerdem müssen Sie die Knoten-XML, die die Ansicht integriert, in die Configuration Manager-Konsole in den Ordner> %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID kopieren, wobei <GUID> der GUID-Bezeichner für den Knoten ist, auf den die Aktion angewendet wird. Weitere Informationen finden Sie im Abschnitt "Knoten" weiter unten in diesem Thema.

Entfernen einer Ansicht

Um eine Ansicht zu entfernen, löschen Sie die Ansichtsassembly aus dem Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin. Sie müssen sicherstellen, dass keine andere Erweiterung auf die Ansicht verweist, bevor Sie sie löschen. Sie müssen auch die XML-Knotendatei der Ansicht aus dem Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> löschen, wobei <GUID> der GUID-Bezeichner für den Knoten ist, auf den die Aktion angewendet wird.

Benutzerdefinierte Verwaltungsklassen

Installieren einer benutzerdefinierten Verwaltungsklasse

Kopieren Sie die Verwaltungsklassenassembly entweder in %ProgramFiles%\ Microsoft Endpoint Manager\AdminConsole\bin oder in den Installationsordner Ihrer Anwendung.

Um eine XML-Datei der benutzerdefinierten Verwaltungsklasse zu installieren, kopieren Sie die Datei in den Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses. Da alle benutzerdefinierten Verwaltungsklassen in diesem Ordner platziert werden, müssen Sie sicherstellen, dass Ihre XML-Datei einen eindeutigen Namen hat. Es wird empfohlen, ihren Firmennamen als Teil des Dateinamens zu verwenden.

Entfernen einer benutzerdefinierten Verwaltungsklasse

Um eine benutzerdefinierte Verwaltungsklasse zu entfernen, löschen Sie die XML-Datei der benutzerdefinierten Verwaltungsklasse. Wenn der Ordner keine anderen XML-Dateien enthält, kann der Ordner sicher entfernt werden.

Nodes

Installieren eines Knotens

Erstellen Sie zum Installieren eines Knotens den Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> , wobei <GUID> der GUID-Bezeichner des übergeordneten Knotens der Configuration Manager Konsole ist. Kopieren Sie die XML-Datei des Knotens in den Ordner GUID. Weitere Informationen finden Sie unter Informationen zu Konsolenknoten.

Entfernen eines Knotens

Löschen Sie zum Entfernen eines Knotens die XML-Knotendatei aus dem Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID>.

Siehe auch

Informationen zur Configuration Manager-Konsolenerweiterung
Informationen zu Configuration Manager KonsolenaktionenInformationen zu KonsolenformularenInformationen zu KonsolenverwaltungsklassenInformationen zu KonsolenknotenInformationen zu Konsolenansichten