Freigeben über


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.