Teilen über

COM+ Administrationssammlungen

  • Artikel

Die COM+-Verwaltungssammlungen dienen zum Speichern und Organisieren von Konfigurationsdaten, die im COM+-Katalog gespeichert sind. Die Auflistungen entsprechen Ordnern in der Konsolenstruktur des Verwaltungstools für Komponentendienste. Sie können auf diese Auflistungen zugreifen, indem Sie die COM+-Verwaltungsobjekte und -schnittstellen verwenden.

Sie initiieren die programmgesteuerte Verwaltung mithilfe von Objekten, die aus der COMAdminCatalog Klasse erstellt wurden, stellen Sie alle Auflistungen im Katalog mithilfe von Objekten dar, die aus der COMAdminCatalogCollection Klasse erstellt wurden, und Sie stellen Elemente in Auflistungen mithilfe von Objekten dar, die aus dem COMAdminCatalogObject Klasse erstellt wurden.

Die Elemente in einer bestimmten Auflistung machen einen konsistenten Satz von Eigenschaften verfügbar. Beispielsweise stellt jedes Element in der Components -Auflistung eine Komponente dar, und die Elemente in der Components -Auflistung machen dieselben Eigenschaften verfügbar, die zum Konfigurieren einer Komponente verwendet werden. Auf diese Eigenschaften kann mithilfe der COMAdminCatalogObject Klasse zugegriffen werden.

Anmerkung

Eigenschaften mit WriteOnce-Zugriff sind ReadWrite bei Verwendung der Add-Methode vor der Verwendung von SaveChanges- und anschließend ReadOnly.

 

Eine Einführung in die programmgesteuerte Verwaltung von COM+ finden Sie unter Automatisieren von COM+ Administration.

Sammlungshierarchie

Die folgende Abbildung veranschaulicht die Beziehungen zwischen den Auflistungen. Die Auflistungen ganz links (in weißen und grauen Feldern) sind Auflistungen der obersten Ebene, auf die durch Aufrufen der GetCollection- Methode eines Objekts zugegriffen wird, das aus der COMAdminCatalog Klasse erstellt wurde. Auf die verbleibenden Auflistungen (in gelben Feldern) kann nur über die übergeordnete Auflistung zugegriffen werden, indem die GetCollection-methode der COMAdminCatalogCollection-Objekt aufgerufen wird, das das übergeordnete Objekt darstellt. Die Pfeile zeigen von einer übergeordneten Auflistung auf die untergeordneten Auflistungen.

Diagramm, das die Beziehungen zwischen den Auflistungen zeigt.

Die folgenden vier Auflistungen sind in der Abbildung nicht dargestellt: ErrorInfo, PropertyInfo, RelatedCollectionInfound Root. Die ErrorInfo--Auflistung ist ein untergeordnetes Element jeder Auflistung in der Abbildung, außer InprocServers und WOWInprocServers- (in grauen Feldern). Die PropertyInfo und RelatedCollectionInfo Auflistungen sind untergeordnete Elemente jeder Auflistung. Die Root--Auflistung ist eine Auflistung der obersten Ebene, die das übergeordnete Element aller anderen Auflistungen auf oberster Ebene ist. Es ist jedoch nicht erforderlich, auf die Root-Auflistung zuzugreifen, bevor auf andere Auflistungen der obersten Ebene zugegriffen wird.

COMAdmin-Bibliothek

Die folgenden Auflistungen werden von der COMAdmin-Bibliothek unterstützt.

Sammlung Beschreibung
ApplicationCluster- Enthält eine Liste der Server im Anwendungscluster.
ApplicationInstances- Enthält ein Objekt für jede Instanz einer ausgeführten COM+-Anwendung.
Anwendungen Enthält ein Objekt für jede COM+-Anwendung, die auf dem lokalen Computer installiert ist.
Komponenten Enthält ein Objekt für jede Komponente in der Anwendung, mit der sie verknüpft ist.
ComputerList- Enthält eine Liste der Computer, die im Ordner Computer des Verwaltungstools für Komponentendienste gefunden wurden.
DCOMProtocols Enthält eine Liste der Protokolle, die von DCOM verwendet werden sollen. Es enthält ein Objekt für jedes Protokoll.
ErrorInfo- Ruft erweiterte Fehlerinformationen zu Methoden ab, die mit mehreren Objekten umgehen.
EventClassesForIID- Ruft Informationen zu Ereignisklassen ab.
FilesForImport- Ruft Informationen aus der MSI-Datei einer Anwendung ab, die importiert werden kann.
InprocServers- Enthält eine Liste der im System registrierten In-Process-Server. Es enthält ein Objekt für jede Komponente.
InterfacesForComponent- Enthält ein Objekt für jede Schnittstelle, die von der Komponente verfügbar gemacht wird, mit der die Auflistung verknüpft ist.
LegacyComponents- Enthält ein Objekt für jede nicht konfigurierte Komponente in der Anwendung, mit der sie verknüpft ist.
LegacyServers- Identisch mit der InprocServers Auflistung, außer dass diese Auflistung auch lokale Server enthält.
LocalComputer- Enthält ein einzelnes Objekt, das Einstellungeninformationen auf Computerebene für den Computer enthält, auf dessen Katalog Sie zugreifen.
MethodsForInterface Enthält ein Objekt für jede Methode auf der Schnittstelle, mit der die Auflistung verknüpft ist.
Partitionen Wird verwendet, um die in jeder Partition enthaltenen Anwendungen anzugeben.
PartitionUsers Wird verwendet, um die In jeder Partition enthaltenen Benutzer anzugeben.
PropertyInfo- Ruft Informationen zu den Eigenschaften ab, die eine angegebene Auflistung unterstützt.
PublisherProperties- Enthält ein Objekt für jede Herausgebereigenschaft für die übergeordnete SubscriptionsForComponent -Auflistung.
RelatedCollectionInfo- Ruft Informationen zu anderen Auflistungen im Zusammenhang mit der Auflistung ab, aus der sie aufgerufen wird.
Rollen Enthält ein Objekt für jede Rolle, die der Anwendung zugewiesen ist, mit der sie verknüpft ist.
RolesForComponent- Enthält ein Objekt für jede Rolle, die der Komponente zugewiesen ist, mit der die Auflistung verknüpft ist.
RolesForInterface- Enthält ein Objekt für jede Rolle, die der Schnittstelle zugewiesen ist, mit der die Auflistung verknüpft ist.
RolesForMethod- Enthält ein Objekt für jede Rolle, die der Methode zugewiesen ist, mit der die Auflistung verknüpft ist.
RolesForPartition Enthält ein Objekt für jede Rolle, die der Partition zugewiesen ist, mit der die Auflistung verknüpft ist.
Stamm- Enthält die Auflistungen der obersten Ebene im Katalog.
SubscriberProperties Enthält ein Objekt für jede Abonnenteneigenschaft für die übergeordnete SubscriptionsForComponent -Auflistung.
SubscriptionsForComponent- Enthält ein Objekt für jedes Abonnement für das übergeordnete Components -Auflistung.
TransientPublisherProperties- Enthält ein Objekt für jede Herausgebereigenschaft für die übergeordnete TransientSubscriptions -Auflistung.
TransientSubscriberProperties Enthält ein Objekt für jede Abonnenteneigenschaft für das übergeordnete TransientSubscriptions -Auflistung.
transientSubscriptions Enthält ein Objekt für jedes vorübergehende Abonnement.
UsersInPartitionRole Enthält ein Objekt für jeden Benutzer in der Partitionsrolle, mit dem die Auflistung verknüpft ist.
UsersInRole- Enthält ein Objekt für jeden Benutzer in der Rolle, mit der die Auflistung verknüpft ist.
WOWInprocServers Enthält eine Liste der im System registrierten In-Process-Server für 32-Bit-Komponenten auf 64-Bit-Computern.
WOWLegacyServers Identisch mit der LegacyServers Auflistung, außer dass diese Sammlung von der 32-Bit-Registrierung auf 64-Bit-Computern gezeichnet wird.