Windows

DocusnapScript.exe erzeugt, nachdem die Daten eines Windows-Systems ermittelt wurden, eine XML-Datei, in welcher alle Informationen enthalten sind. Diese XML-Datei kann in weiterer Folge in Docusnap importiert werden bzw. durch den Docusnap-Server automatisiert importiert werden.

Bei der Installation von Docusnap wird die DocusnapScript.exe im Anwendungsverzeichnis im Ordner Tools abgelegt. Für die Ausführung der DocusnapScript.exe sind keine weiteren Dateien notwendig.

Parameter:

• C: Legt den Namen der Arbeitsstation fest.
• D: Legt den Namen der Domäne fest, in dem sich das auszulesende System befindet.
• H: Ruft den Hilfetext auf.
• L: Legt das Debuglevel fest, das bei der Inventarisierung verwendet wird.
  Es gibt folgende Debuglevel:
  1. Fehler und Funktionsaufrufe werden geloggt
  2. Es wird der gesamte Programmablauf geloggt
• O: Legt den Pfad fest, in dem die XML-Datei generiert werden soll. Falls ein Logfile angelegt wird, wird es in diesen Pfad gespeichert.

Beispiele:

Wird das System inventarisiert, auf dem das Script ausgeführt wird, müssen keine zusätzlichen Parameter angegeben werden. Durch -O kann der Speicherpfad für die XML-Datei gewählt werden.

Soll nicht das System inventarisiert werden, auf dem das Script ausgeführt wird, sondern ein anderes System im Netzwerk, so kann mit den Parametern -C und -D das auszulesende System bestimmt werden.

Inventarisiert den Arbeitsplatz WKNE006 in der Domäne intern.local im Debuglevel 2 und legt die generierte XML-Datei unter C:\DocusnapSkripte ab.

Software- und Dateisuche

Mit Hilfe der Software- und Dateisuche bietet Docusnap ein zusätzliches Feature an, um spezifischer Dateien auf dem Dateisystem von Linux-, Mac- und Windows-Systemen zu inventarisieren, welche nicht über die Windows-Inventarisierung erfasst werden können. Die gefundenen Dateien werden je nach Kategorisierung (Dateisuche Linux, Mac und Windows oder Softwaresuche Windows) auf unterschiedlichen Wegen in Docusnap zur Auswertung bereitgestellt. Die Software- und Dateisuche kann auch bei der Ausführung des Docusnap-Skriptes verwendet werden. Um die Software- und Dateisuche verwenden zu können, muss eine XML-Liste manuell erstellt werden.

Die XML-Datei hat folgenden Aufbau:

<?xml version="1.0" encoding="UTF-8" ?>
<Search>
<SearchItem><!--Dateisuche-->
	<Name>log4j</Name>
	<FileName>*log4j*</FileName>
	<FileSize>0</FileSize>
	<Category>1</Category>
	<IncludeExcludeList>
	<SearchPath>
	<IncludePath>c:\windows</IncludePath>
	<ExcludePath></ExcludePath>
	</SearchPath>
	<SearchPath>
	<IncludePath>c:\temp</IncludePath>
	<ExcludePath></ExcludePath>
	</SearchPath>
	</IncludeExcludeList>
	<OnlyFirstMatch>true</OnlyFirstMatch>
	<UseSystemDrive>false</UseSystemDrive>
</SearchItem>
<SearchItem><!--Softwaresuche-->	
	<Name>Notepad</Name>
	<Version></Version>
	<Publisher></Publisher>
	<FileName>notepad.exe</FileName>
	<FileSize>0</FileSize>
	<ModifyDate></ModifyDate>
	<SearchPath>c:\temp</SearchPath>
	<Category>0</Category>
</SearchItem>
</Search>

Die Suche ist abwärtskompatibel somit sind bestehende Ausführungen nicht betroffen. Die bisher verwendeten XML-Dateien für die Softwaresuche können auch weiterhin verwendet werden.

<SoftwareItem>
<SoftwareName>Meine Neue Software 1</SoftwareName>
<SoftwarePublisher>Microsoft</SoftwarePublisher> <!-- optional-->
<SoftwareVersion>1.0 Beta</SoftwareVersion> <!-- optional-->
<FileName>notepad.exe</FileName>
<SearchPath>C:\Windwos</SearchPath>
<FileSize>193536</FileSize> <!-- optional byte-->
<ModifyDate>01.01.2016</ModifyDate> <!-- optional-->
</SoftwareItem>

<SoftwareItem>
<SoftwareName>Meine Neue Software 1</SoftwareName>
<SoftwarePublisher /> <!-- optional-->
<SoftwareVersion /> <!-- optional-->
<FileName>notepad.exe</FileName>
<SearchPath>C:\Windwos</SearchPath>
<FileSize /> <!-- optional byte-->
<ModifyDate /> <!-- optional-->
</SoftwareItem>

Der Aufruf der Softwareliste in DocusnapScript erfolgt mit folgendem Aufruf:
DocusnapScript.exe -S <Pfad><Dateiname.xml>

Wird bei der Ausführung des Scripts eine definierte Software gefunden, wird diese in der Ergebnis XML-Datei gespeichert und beim Import dieser Datei in Docusnap ausgegeben.

Zusatzprogramme

Durch die Verwendung von Zusatzprogrammen können bei der Inventarisierung zusätzliche Informationen zu einem Windows-System erfasst werden. Die Ausführung der Zusatzprogramme kann auch im Rahmen des Docusnap-Skriptes gestartet werden. Um die Zusatzprogramme auszuführen, muss eine XML Datei mit den benötigten Informationen erstellt werden.

Die XML-Datei hat folgenden Aufbau:

<ToolInfo>
 <Url>systeminfo.exe</Url>
 <Parameters> </Parameters>
 <ResultFile>systeminfo.txt</ResultFile>
 <OpenWith>notepad.exe</OpenWith>
 <Description>Systeminfo</Description>
 <ToolType>0</ToolType>
 <Timeout>10000</Timeout>
 <ExecuteRemote>false</ExecuteRemote>
</ToolInfo>

Der Aufruf der Zusatzprogramme in DocusnapScript erfolgt mit folgendem Aufruf:
DocusnapScript.exe -Y <Pfad><Dateiname.xml>

Daten, die bei der Ausführung der Zusatzprogramme im Zuge des Scripts gesammelt werden, werden in der Ergebnis XML-Datei gespeichert und beim Import dieser Datei in Docusnap ausgegeben.

Auswahl der Scankomponenten -Z

Seit der Version 11 liefert Docusnap die Möglichkeit, die zu inventarisierenden Komponenten bei den Windows Systemen auszuwählen (Software, Updates, Dienste etc.). Diese Auswahl der Komponenten kann auch bei Nutzung der DocusnapScript.exe durchgeführt werden.

Der Aufruf erfolgt über den Parameter -Z .

Die notwendige Zahl kann auf zwei Wegen ermittelt werden:

1. Windows Scan Assistenten

Im Windows Scan Assistenten (AD oder IP) befindet sich im Schritt 3 die Schaltfläche Komponenten Auswählen. Über diese Schaltfläche kann definiert werden welche Komponenten inventarisiert werden sollen. Der Wert in im Textfeld DS Skript Parameter kann anschließend bei der Ausführung des Scripts verwendet werden um nur bestimmte Komponenten zu inventarisieren.

2. Manuelles Aufzählen

In der Hilfe der DocusnapScript.exe kann die spezifisch Hilfe für die Scankomponenten geöffnet werden: DocusnapScript.exe -H scan.

Nun können die entsprechenden Komponenten festgelegt werden, indem die dahinter befindlichen Zahlen addiert werden.

##Dateinamen anonymisieren -ANO Die .XML-Dateien, die von der DocusnapScript.exe erstellt werden, werden wie folgt benannt.

• Computername
• Benutzer oder System, der die Ausführung der DocusnapScript.exe durchgeführt hat.
• Datum und Uhrzeit der Ausführung

Beispiel:
VPC-SDA_VPC-SDA_admin_20210323090358.xml

Durch die Ausführung der DocusnapScript.exe mit dem Parameter -ANO wird der Dateiname anonymisiert.

Beispiel:
383ee2d1-46ae-4cbc-b2f9-b4dc437bf911.xml