INHALTSVERZEICHNIS


Vorbereitung


Du benötigst unser Powershell Helper Modul. Falls Du dieses noch nicht installiert hast, führe bitte folgendes FAQ durch:

→ https://servereye.freshdesk.com/support/solutions/articles/14000070083-installation-powershell-helper-modul


ACHTUNG:

Derzeit funktioniert das Anlegen von Alarmierungen über die PowerShell nicht mit der Helper Version 2.19., stattdessen muss hierfür die vorherige Version 2.18. genutzt werden!

Zunächst muss die PowerShell als Admin gestartet werden, dann ist folgender Befehl einzugeben:

Install-Module -Name ServerEye.Powershell.Helper -RequiredVersion 2.18.0


Zum Laden der PowerShell Helper:

Import-Module -Name ServerEye.Powershell.Helper


Zum Anmelden am Helper:

Connect-SESession -persist


Im dann aufpoppenden Fenster musst Du Deine Login-Daten zum servereye-OCC angeben.



Variante 1 - Alarmierung


Führe nun folgenden Befehl aus, um die gewünschten Alarmierungen anzulegen. Die Filter sind optional, Du kannst sie weggelassen, wenn keine Filterung gewünscht ist.


Get-SECustomer -Filter "Kundenname" | Get-SESensorhub -Filter "SensorhubName" | Get-SESensor -Filter "Sensorname" | New-SENotification -UserID "ID des Users"


Du erhältst die Ausgabe in der PowerShell, jetzt wurde nur eine Alarmierung erstellt, es wird aber keine E-Mail, SMS oder ein Ticket erstellt.


Dafür gibt es diese Parameter:

  1. SendEmail
  2. SendTextmessage
  3. SendTicket


Beispiel, wenn eine E-Mail gesendet werden soll:


Get-SECustomer -Filter "Kundenname" | Get-SESensorhub -Filter "SensorhubName" | Get-SESensor -Filter "Sensorname" | New-SENotification -UserID "ID des Users" -SendEmail


Die benötigte User-ID kannst Du mit dem Befehl herausfinden:

Get-SEUser


Ausgabe Beispiel, hier die User-ID des gewünschten Users kopieren:


Variante 2 - Alarmierung mit Verzögerung


Zusätzlich kann via PowerShell auch eine Verzögerung für die Alarmierung mitgegeben werden. Dazu benötigst Du zuerst die ID der Verzögerung. Die ID kannst Du mit folgendem Befehl ausgeben lassen:

Get-SEDispatchTime

Ausgabe Beispiel, hier die DispatchTimeID der gewünschten Verzögerung kopieren:



Nun fügst Du noch diesen Befehl hinzu:

DeferID


Beispiel für die vollständige Befehlszeile einer E-Mail Alarmierung mit Verzögerung:


Get-SECustomer -Filter "Kundenname" | Get-SESensorhub -Filter "SensorhubName" | Get-SESensor -Filter "Sensorname" | New-SENotification -UserID "ID des Users" -SendEmail -DeferID "ID der Verzögerung"


Variante 3 - Alarmierung gefiltert auf bestimmte Tags


Falls nicht jeder Sensorhub oder Sensor genommen werden soll, kannst Du zusätzlich auch auf Basis von Tags filtern. Dazu ergänze den Befehl aus Variante 1 oder 2 noch um folgenden Befehl:

Get-SESensortag | Where-Object {$_.Tag -like "Gesuchter Tag"}


Als "Gesuchter Tag" gebe bitte den exakten Namen des Tags aus dem OCC ein.


Als Beispiel hier der volle Befehl aus Variante 1 mit Filterung auf Tags:

Get-SECustomer -Filter "Kundenname" | Get-SESensorhub -Filter "SensorhubName" | Get-SESensor -Filter "Sensorname" | Get-SESensortag | Where-Object {$_.Tag -like "Gesuchter Tag"} | New-SENotification -UserID "ID des Users"


und der volle Befehl aus Variante 2 mit Filterung auf Tags und Alarmierungsverzögerung:

Get-SECustomer -Filter "Kundenname" | Get-SESensorhub -Filter "SensorhubName" | Get-SESensor -Filter "Sensorname" | Get-SESensortag | Where-Object {$_.Tag -like "Gesuchter Tag"} | New-SENotification -UserID "ID des Users" -SendEmail -DeferID "ID der Verzögerung"


Hier gilt es zu beachten, dass es einen Unterschied dabei gibt, Tags direkt in der PowerShell anzusprechen:

Get-SESensorhubtag = Get a list of all Tags from a Sensorhub.

Get-SESensortag  =  Get a list of all Tags from a Sensor.
Get-SETag  =  Get a list of all Tags.


Schließe nun die PowerShell Session mit folgendem Befehl

Disconnect-SESession