Freigeben über

INDEX-Klausel

  • Artikel

Die INDEX-Klausel gibt einen Schlüssel zum Auswählen einer eindeutigen Zeile in einer Skalar- oder Tabellensammlung an. Der SNMP-Anbieter wird abhängig vom Typ der vom SNMP-Gerät verwendeten Tabelle einem anderen CIM-Klassentyp zugeordnet. Da ein Schlüssel mehr als eine Art von Objekt sein kann, verwendet der Anbieter je nach Objekttyp innerhalb des Schlüssels unterschiedliche Zuordnungsregeln. Weitere Informationen finden Sie unter INDEX-Klausel-Datentypen.

Hinweis

Weitere Informationen zum Installieren des Anbieters finden Sie unter Einrichten der WMI-SNMP-Umgebung.

 

Eine Skalarsammlung wird einer CIM-Singletonklasse zugeordnet, d. h. einer Klasse, die nur eine Instanz hat. Da es nicht erforderlich ist, eine Instanz von einer anderen eindeutig zu unterscheiden, gibt eine Singletonklasse keine oder mehrere Eigenschaften als Schlüssel an. Für aus Skalarsammlungen generierte Klassen gilt:

  • Sie enthalten keine Key-Eigenschaftsqualifizierer.
  • Sie enthalten den Standard-CIM-Klassenqualifizierer Singleton vom Typ Bool.

Eine Tabellensammlung wird einer CIM-Klasse zugeordnet, die mehrere Instanzen haben 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 des OBJECT-TYPE-Makros einer Tabellensammlung gibt den Satz der Schlüsseleigenschaften der Sammlung an. Die folgenden Zuordnungsregeln gelten:

  • Der CIM-Qualifizierer Key vom 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 Schlüssel. Dieser Qualifizierer ist ein ganzzahliger 32-Bit-Wert ohne Vorzeichen, der für die MOF-Qualifizierersyntax mithilfe der Zweierkomplement-Operation in einen ganzzahligen 32-Bit-Wert mit Vorzeichen konvertiert werden muss.

Derzeit behandelt die Zuordnung der SNMPv2C INDEX-Klausel nicht die Verwendung des IMPLIZITEN 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 Angabe von Schlüsseleigenschaften nicht einfach. Stattdessen sollten Sie die Möglichkeiten in Betracht ziehen, dass die INDEX-Klausel einen oder mehrere der folgenden Datentypen enthalten kann:

  • Intern zugänglicher indexobject-Wert

    Der indexobject-Wert ist ein benannter Wert, der sich auf eine MIB-Objektdefinition bezieht, die in der konzeptionellen Zeile derselben Tabelle angezeigt wird, die die INDEX-Klausel enthält. Die MIB-Objektdefinition, auf die in der INDEX-Klausel verwiesen wird, wird einer Schlüsseleigenschaft der CIM-Klassendefinition zugeordnet.

  • Extern zugänglicher indexobject-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.

  • Zugänglicher indextype-Wert

    Der indextype-Wert ist ein benannter Typ, der auf einen der folgenden Datentypen verweist: INTEGER, OCTET STRING, OBJECT IDENTIFIER, NetworkAddress oder IpAddress. Wenn die INDEX-Klausel einen Verweis vom Typ „MIB“ enthält, gelten die folgenden Zuordnungsregeln:

    • Das MIB-Objekt, auf das verwiesen wird, wird einer Schlüsseleigenschaft der CIM-Klassendefinition zugeordnet. Die Typsyntax basiert auf dem angegebenen indextype-Wert, der CIM-Eigenschaftsqualifizierern mithilfe der standardmäßigen SYNTAX-Klausel-Zuordnungsverfahren zugeordnet wird.
    • Der Zuordnungsprozess generiert einen eindeutigen Eigenschaftsnamen, indem der MIB-Tabellenobjektdeskriptor, ein Unterstrich (_) und die Rangreihenfolge des indextype-Werts der INDEX-Klausel verkettet werden. Der Eigenschaftenname für die dritte Komponente indextype der MIB-Tabelle enterpriseIfTable ist beispielsweise 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 Instanz Informationen berechnen soll, die allen zugänglichen MIB-Objektdefinitionen in der Klassendefinition zugeordnet sind.
    • Die CIM-Klassendefinition muss mindestens eine Eigenschaft enthalten, der kein Virtual_Key-Qualifizierer zugeordnet ist. Wenn diese Eigenschaft nicht angegeben wird, 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.