PowerShell-Skripting

Mit PowerShell-Skripting können Sie unter Verwendung von Windows PowerShell benutzerdefinierte Leistungsmonitore erstellen.

Important: WhatsUp Gold verwendet eine 32-Bit-PowerShell-Engine (d. h. x86). Daher werden nur 32-Bit-PowerShell-Snap-ins unterstützt. Die reinen 64-Bit-Snap-ins funktionieren nicht. Snap-Ins, die sowohl mit 32-Bit- als auch mit 64-Bit-Betriebssystemen verwendet werden können, sind standardmäßig für 64-Bit-Systeme konfiguriert. Damit sie ordnungsgemäß mit WhatsUp Gold funktionieren, muss für sie eine manuelle Konfiguration für die 32-Bit-PowerShell-Engine vorgenommen werden.

Für den Leistungsmonitor für PowerShell-Skripting sind folgende Anmeldeinformationen erforderlich:

• Windows

So konfigurieren Sie den Leistungsmonitor für PowerShell-Skripting mit Hilfe folgender Felder:

• Name. Name des Leistungsmonitors. Dieser Name wird in der Monitorbibliothek angezeigt.
• Beschreibung. Optionale Beschreibung des Leistungsmonitors, die als Spaltendaten in der Monitorbibliothek angezeigt wird.
• Zeitüberschreitung. Die Zeitspanne, die WhatsUp Gold versucht, eine Verbindung zum ausgewählten Gerät herzustellen. Die Verbindung gilt in diesem Fall als fehlgeschlagen.
• Abfrageintervall. Legen Sie fest, wie oft aktualisierte Informationen zum Gerät durch WhatsUp Gold abgefragt werden sollen.

  Note: Die maximal zulässige Zeitüberschreitung beträgt zwar 60 Sekunden, es wird jedoch empfohlen, als Zeitüberschreitung höchstens 10 Sekunden festzulegen. Sie sollten eine möglichst kleine Zeitspanne festlegen.

• Referenzvariablen. SNMP- und WMI-Referenzvariablen können Sie hinzufügen, bearbeiten oder löschen. In den folgenden Schritten wird die Konfiguration eines Leistungsmonitors für SNMP- bzw. WMI-PowerShell-Skripting beschrieben.

  Note: Die Verwendung von Referenzvariablen im Leistungsmonitor für PowerShell ist optional. Falls Sie sich für eine Verwendung entscheiden, müssen Sie Context.GetReferenceVariable in Ihr Skript aufnehmen, damit die Referenzvariablen abgefragt und die Daten grafisch dargestellt werden. Referenzvariablen erleichtern Ihnen das Erstellen von Code und ermöglichen Ihnen das effiziente Schreiben von Skripts, ohne dass Sie auf eine Liste von Geräteeigenschaften zurückgreifen müssen, wie es beim Script-Action- und beim Script-Active-Monitor der Fall ist. Mit den Variablen werden die zugrunde liegenden SNMP- oder WMI-Mechanismen verwaltet, deren Verwaltung in der Regel von Ihnen übernommen werden müsste, um auf einem Remote-Gerät auf SNMP- oder WMI-Indikatoren zugreifen zu können.
  Bei Verwendung von Context.GetReferenceVariable (Variablenname) müssen Sie nur den Namen einer vorab festgelegten Variable angeben. WhatsUp Gold verwendet zum Abrufen der angeforderten Informationen Geräte-Anmeldeinformationen und stellt mit Hilfe von SNMP oder WMI eine Verbindung zum Zielgerät her. Diese Informationen werden in einer Variable gespeichert, die Sie später in Ihrem Skript verwenden können. Weitere Informationen können Sie unter Verwenden des Kontextobjekts bei Leistungsmonitoren nachlesen.

• Mit Windows-Anmeldeinformationen ausführen, die dem Gerät zugewiesen wurden. Aktivieren Sie die Option, um das Skript mit den Windows-Anmeldeinformationen für das betreffende Gerät auszuführen.
• Skripttext. Geben Sie den Skriptcode für den Monitor ein.

  Important: Bei der ersten Abfrage einer WMI-Referenzvariable, für die zur Errechnung des Mittelwerts (wie etwa „Prozessor\% Prozessorzeit“) zwei Abfragen erforderlich sind, wird „Null“ zurückgegeben.

So konfigurieren Sie einen Leistungsmonitor für das SNMP-PowerShell-Skripting:

1. Klicken Sie auf im Dialogfeld „Leistungsmonitor für PowerShell-Skripting“ und fügen Sie eine neue Variable in das Feld Referenzvariablen ein. Das Dialogfeld „Neue Referenzvariable hinzufügen“ wird angezeigt.
2. Geben Sie die entsprechenden Informationen ein:
   • Variablenname. Geben Sie der Variable einen eindeutigen Namen.
   • Beschreibung. (Optional) Geben Sie eine kurze Beschreibung für die Variable ein.
3. Wählen Sie das Optionsfeld SNMP aus.
4. Geben Sie für die Verbindung zum Gerät die Zeitüberschreitung und die Anzahl der Wiederholungsversuche ein. Das Ausfüllen dieser Felder ist optional.
5. Öffnen Sie den MIB-Browser mit Auswählen.
6. Geben Sie in das Feld Leistungsindikatoren auswählen von Computer den Namen oder die IP-Adresse des Computers ein, zu dem eine Verbindung hergestellt werden soll. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und ein Gerät aus einer Liste auswählen.
7. Wählen Sie die SNMP-Anmeldeinformationen zur Herstellung einer Verbindung zum Gerät aus. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und in der Anmeldeinformationen-Bibliothek neue Anmeldeinformationen erstellen.
8. In den Feldern Zeitüberschreitung und Anzahl der Wiederholungsversuche können Sie die Zeitdauer und die Anzahl der Wiederholungsversuche für den Computer anpassen, zu dem eine Verbindung hergestellt werden soll.
9. Klicken Sie auf OK.
10. Wählen Sie mit Hilfe der Navigationsstruktur die jeweilige MIB aus, die überwacht werden soll. Weitere Informationen zu den Eigenschaften/Werten sind unten im Dialogfeld zu sehen.
11. Klicken Sie auf OK und geben Sie anschließend im Dialogfeld „Neue Referenzvariable hinzufügen“ die OID in die Felder Leistungsindikator und Instanz ein.
12. Überprüfen Sie die Konfiguration und klicken Sie auf OK. Fügen Sie anschließend im Dialogfeld „Leistungsmonitor für PowerShell-Skripting“ die Variable in die Referenzvariablenliste ein.
13. Fügen Sie Ihren Monitorcode in das Feld Skripttext ein.
14. Klicken Sie auf OK, um die Änderungen zu speichern.

So konfigurieren Sie einen Leistungsmonitor für WMI-PowerShell-Skripting:

1. Klicken Sie auf im Dialogfeld „Leistungsmonitor für PowerShell-Skripting“ und fügen Sie eine neue Variable in das Feld Referenzvariablen ein. Das Dialogfeld „Neue Referenzvariable hinzufügen“ wird angezeigt.
2. Geben Sie die entsprechenden Informationen ein:
   • Variablenname. Geben Sie der Variable einen eindeutigen Namen.
   • Beschreibung. (Optional) Geben Sie eine kurze Beschreibung für die Variable ein.
3. Wählen Sie das Optionsfeld WMI aus.
4. Öffnen Sie den MIB-Browser mit Auswählen.
5. Geben Sie in das Feld Leistungsindikatoren auswählen von Computer den Namen oder die IP-Adresse des Computers ein, zu dem eine Verbindung hergestellt werden soll. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und ein Gerät aus einer Liste auswählen.
6. Wählen Sie die Windows-Anmeldeinformationen zur Herstellung einer Verbindung zum Gerät aus. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und in der Anmeldeinformationen-Bibliothek neue Anmeldeinformationen erstellen.
7. Klicken Sie auf OK.
8. Wählen Sie mit Hilfe der Navigationsstruktur die jeweilige MIB aus, die überwacht werden soll. Weitere Informationen zu den Eigenschaften/Werten sind unten im Dialogfeld zu sehen.
9. Klicken Sie auf OK und geben Sie anschließend im Dialogfeld „Neue Referenzvariable hinzufügen“ die OID in die Felder Leistungsindikator und Instanz ein.
10. Überprüfen Sie die Konfiguration und klicken Sie auf OK. Fügen Sie anschließend im Dialogfeld „Leistungsmonitor für PowerShell-Skripting“ die Variable in die Referenzvariablenliste ein.
11. Fügen Sie Ihren Monitorcode in das Feld Skripttext ein.
12. Klicken Sie auf OK, um die Änderungen zu speichern.

See Also Leistungsmonitore Active-Script (Leistung) APC-USV (Leistung) AWS-CloudWatch (Leistungsmonitor) Azure-Cloud (Leistungsmonitor) Azure-Cloud (Abrechnung und Nutzung) CPU-Auslastung (Leistung) Datenträgerauslastung (Leistung) Leistungsmonitor für Tinte/Toner von Druckern Datenträger-Aktivität – virtuelle Hyper-V-Maschinen JMX (Leistung) Schnittstellenauslastung Arbeitsspeicherauslastung (Leistung) Ping-Latenz und -Verfügbarkeit SNMP (Leistung) SQL-Abfrage (Leistung) SSH (Leistung) IOPS für VMware-Datenspeicher Windows-Leistungsindikator Konfigurieren von WMI-formatierten Indikatormonitoren WMI-Leistungsmonitor Monitor für das Hyper-V-Ereignisprotokoll Monitor für virtuelle Maschinen auf Hyper-V-Hosts