INDEX-Klausel
Die INDEX-Klausel gibt einen Schlüssel an, um eine eindeutige Zeile in einer Skalar- oder Tabellenauflistung auszuwählen. Der SNMP-Anbieter ordnet je nach Tabellentyp, den das SNMP-Gerät verwendet, einer anderen CIM-Klasse zu. Da ein Schlüssel mehrere Objekttypen sein kann, verwendet der Anbieter je nach Objekttyp innerhalb des Schlüssels unterschiedliche Zuordnungsregeln. Weitere Informationen finden Sie unter INDEX-Klausel-Datentypen.
Anmerkung
Weitere Informationen zum Installieren des Anbieters finden Sie unter Einrichten der WMI SNMP Environment.
Eine skalare Auflistung ist einer CIM-Singletonklasse zugeordnet, d. h. einer Klasse, die nur eine Instanz haben kann. Da es nicht erforderlich ist, eine Instanz von einer anderen eindeutig zu identifizieren, bestimmt eine Singleton-Klasse keine oder mehrere Eigenschaften als Schlüssel. Klassen, die aus Skalarsammlungen generiert werden:
- Enthalten Sie keine Key--Eigenschaftsqualifizierer.
- Enthalten Sie den Standard-CIM-Klassenqualifizierer Singleton-, der vom Typ Boolist.
Eine Tabellenauflistung ist einer CIM-Klasse zugeordnet, die mehrere Instanzen aufweisen kann. Daher muss die CIM-Klassendefinition mindestens eine Eigenschaft enthalten, die den Objektschlüssel definiert; d. h. eine Eigenschaft, die eine Instanz der Klasse eindeutig identifiziert. Die INDEX-Klausel der OBJECT-TYPE- Makros einer Tabellenauflistung gibt den Satz der Schlüsseleigenschaften der Auflistung an. Es gelten die folgenden Zuordnungsregeln:
Der CIM-Qualifizierer Key, typ Bool, definiert eine Schlüsseleigenschaft.
Die Reihenfolge der INDEX-Informationen innerhalb der Tabellensammlung definiert die Reihenfolge der Schlüssel innerhalb der CIM-Klassendefinition.
Der CIM-Qualifizierer Key_Order definiert die Reihenfolge der Tasten. Bei diesem Qualifizierer handelt es sich um einen nicht signierten ganzzahligen 32-Bit-Wert, der im Sinne der MOF-Qualifizierersyntax in einen signierten ganzzahligen 32-Bit-Wert konvertiert werden muss, wobei der Zwei-Komplement-Vorgang verwendet wird.
Derzeit behandelt die Zuordnung der SNMPv2C INDEX-Klausel nicht die Verwendung des IMPLIED Qualifizierers. In diesem Fall wird keine CIM-Klassendefinition generiert.
INDEX-Klausel-Datentypen
Aufgrund der Flexibilität der INDEX-Klausel innerhalb des OBJECT-TYPE- Makros ist die Spezifikation von Schlüsseleigenschaften nicht einfach. Stattdessen sollten Sie die Möglichkeiten berücksichtigen, die die INDEX-Klausel möglicherweise einen oder mehrere der folgenden Datentypen enthalten kann:
Intern zugänglich indexobject Wert
Das Indexobjekt- Werts ist ein benannter Wert, der auf eine MIB-Objektdefinition verweist, die in der konzeptionellen Zeile derselben Tabelle angezeigt wird, die die INDEX-Klausel enthält. Die in der INDEX-Klausel genannte MIB-Objektdefinition entspricht einer schlüsseleigenschaft der CIM-Klassendefinition.
Extern zugänglich Indexobjekt- Wert
In diesem Fall ist indexobject ein benannter Wert, der auf eine MIB-Objektdefinition verweist, die in der konzeptionellen Zeile einer anderen Tabelle angezeigt wird.
Barrierefreier Indextyp Wert
Der Indextyp Wert ist ein benannter Typ, der auf einen der folgenden Datentypen verweist: INTEGER, OCTET STRING, OBJECT IDENTIFIER, NetworkAddressoder IpAddress. Wenn die INDEX-Klausel einen MIB-Typverweis enthält, gelten die folgenden Zuordnungsregeln:
- Das MIB-Objekt verweist auf eine Schlüsseleigenschaft der CIM-Klassendefinition. Die Typsyntax basiert auf dem Indextyp angegebenen Werts, der CIM-Eigenschaftsqualifizierern mithilfe der standardmäßigen SYNTAX-Klausel Zuordnungsprozeduren zugeordnet wird.
- Der Zuordnungsprozess generiert einen eindeutigen Eigenschaftsnamen, indem der MIB-Tabellenobjektdeskriptor, ein Unterstrich (_) und die Rangreihenfolge der INDEX-Klausel Indextyp Wert verkettet werden. Beispielsweise ist der Eigenschaftenname für die dritte Komponente Indextyp der MIB-Tabelle enterpriseIfTable-enterpriseIfTable_3.
- Die CIM-Eigenschaft wird mit dem Virtual_Key Qualifizierer kommentiert. Dieser Qualifizierer gibt an, dass der SNMP-Anbieter den Wert der Eigenschaft basierend auf der Obermenge der Instanzinformationen berechnen soll, die allen zugänglichen MIB-Objektdefinitionen in der Klassendefinition zugeordnet sind.
- Die CIM-Klassendefinition muss mindestens eine Eigenschaft enthalten, die keinen Virtual_Key Qualifizierer zugeordnet ist; fehler beim Angeben dieser Eigenschaft wird die Klassendefinition ungültig.
Untertyp mit fester Länge
Wenn die INDEX-Klausel einer SNMP-Tabellenauflistung einen SNMP-unterstützten Typ enthält, der als OCTET STRING mit fester Länge subtypisiert ist, muss der CIM-Eigenschaftsqualifizierer Fixed_Length verwendet werden, um diesen Wert anzugeben.