Zusatzprogramme

Docusnap bietet die Möglichkeit, zusätzliche Programme im Zuge der Inventarisierung von Windows-Systemen auszuführen.

Ein Beispiel für ein Zusatztool ist das Programm Systeminfo.exe. Nach Abschluss des Inventarisierungsvorgangs startet Docusnap die Systeminfo.exe unter Berücksichtigung der definierten Parameter. Die Ergebnisse, die das Zusatzprogramm liefert, werden in der Datenbank gespeichert.

Über die Schaltfläche Neu wird das gewünschte Zusatzprogramm angelegt. Der Name des Programms ist dabei frei definierbar und wird als Bezeichnung für die Ergebnisdatei verwendet. Im Textfeld Programmpfad wird das ausführbare Programm eingetragen bzw. kann es über die Schaltfläche ausgewählt werden. Die eingetragenen Parameter werden an das Programm übergeben. Optionale Parameter werden mit “[ ]” gekennzeichnet. Wenn keine Parameter benötigt werden, muss zumindest ein Leerzeichen eingegeben werden, damit das Zusatzprogramm gespeichert werden kann.

Bei der Auswahl des Typs stehen zwei Möglichkeiten zur Verfügung:

• Datei Bei der Wahl von Datei wird während der Inventarisierung eine temporäre Datei auf der Festplatte angelegt, in der die Ergebnisse gespeichert werden. Diese Datei wird anschließend eingelesen und in die Datenbank gespeichert. Für die Umleitung der Daten in eine Ergebnisdatei steht zusätzlich der Parameter %targetfile% zur Verfügung. Z.B. Systeminfo.exe > %targetfile% bewirkt, dass die ausgegebenen Daten in der im Textfeld definierten Ergebnisdatei gespeichert werden.
• Stream Bei der Wahl von Stream werden die Ergebnisse von der Standardausgabe sofort in die Datenbank geschrieben. Dabei wird allerdings für kurze Zeit die cmd.exe sichtbar.

Das Timeout gibt an, wie lange das Zusatzprogramm Zeit hat, die Ausführung abzuschließen. Wird dieser Zeitraum überschritten, wird das Zusatzprogramm von Docusnap beendet.

Im Feld Öffnen mit wird das Programm definiert, mit dem die Ergebnisdatei geöffnet werden soll.

Mit dem Kontrollkästchen Zusatzprogramm remote ausführen wird definiert, ob das Programm auf dem System ausgeführt wird, an dem der Inventarisierungsvorgang stattfindet, oder remote bei dem jeweiligen System, das gerade inventarisiert wird.

Um Zusatzprogramme bei der Inventarisierung auswählen zu können, besteht die Notwendigkeit, den Einzelschritt Zusatzprogramme im Dialog Konfiguration - Inventarisierung zu aktivieren.

Docusnap stellt die nachfolgenden Umgebungsvariablen zur Verfügung:

• %Hostname%, %Computername%
• %Ipaddress%, %Ipadresse%
• %Domainname%, %Domain%, %Domäne
• %ShortHostname%
• %FQDN%
• %Username%, %Benutzer%
• %Password%, %Passwort%
• %Targetfile%, %Zieldatei%
• %Description%, %Beschreibung%
• %Tool%, %Toolname%
• %accountname%

Beispiele lokale Ausführung:

A:

• Name: Systeminfo
• Programmpfad: systeminfo.exe
• Parameter: /S %hostname% [/U %username% /P %password%] > %targetfile%
• Ergebnisdatei: systeminfo.txt
• Öffnen mit: notepad.exe
• Typ: Datei

B:

• Name: Systeminfo
• Programmpfad: systeminfo.exe
• Parameter: /S %hostname% [/U %username% /P %password%]
• Ergebnisdatei: systeminfo.txt
• Öffnen mit: notepad.exe
• Typ: Stream

Beispiel Remote Ausführung: Power Shell

• Name: Demo - Remote Powershell Aufruf
• Programmpfad: %systemroot%\System32\WindowsPowerShell\v1.0\powershell.exe
• Parameter: (get-wmiobject win32_Operatingsystem)
• Ergebnisdatei: PowerShellDemo.txt
• Öffnen mit: notepad.exe
• Typ: Stream

- ipconfig ^| Select-String -Pattern \"IPv4-Adresse\" (Escape notwendig)
- -Command "&{ipconfig | Select-String -Pattern \"IPv4-Adresse\"}" (Kein Escape der Pipe notwendig)