Docusnap X - Docusnap Script Windows · This document contains proprietary information and may not...

Docusnap X - Docusnap Script Windows Skriptbasierte Inventarisierung für Windows

Skriptbasierte Inventarisierung für Windows | itelio GmbH

Docusnap X - Docusnap Script Windows | ©2018 Docusnap – Alle Rechte vorbehalten Seite 2 von 23

Die Weitergabe, sowie Vervielfältigung dieser Unterlage, auch von Teilen, Verwertung und Mitteilung ihres Inhaltes ist nicht gestattet, soweit nicht ausdrücklich durch die itelio GmbH zugestanden. Zuwiderhandlung verpflichtet zu Schadenersatz. Alle Rechte vorbehalten.

This document contains proprietary information and may not be reproduced in any form or parts whatsoever, nor may be used by or its contents divulged to third parties without written permission of itelio GmbH. All rights reserved.

TITEL Docusnap X - Docusnap Script Windows AUTOR Docusnap Consulting DATUM 15.01.2019 VERSION 1.1 | gültig ab 26.09.2018



INHALTSVERZEICHNIS

Einleitung 4

Grundlagen 5

2.1 Speicherort 5

2.2 Funktion 5

2.3 Automatisierung 6

2.4 Benötigte Rechte 6

2.5 Parameter 7

2.6 Docusnap Script Legacy 8

Zentrale Ausführung 9

3.1 Vorbereitungen 9

3.2 Die Verwaltungskonsole (GPMC) 9

3.3 GPMC starten 10

3.4 Einbindung mittels parametrisierter GPO 11

3.5 Einbindung mittels VB-Skript 13

3.6 Verwendung eines WMI-Filters 15

3.6.1 Erstellung 15

3.6.2 Zuweisung 16

Manuelle Ausführung 18

4.1 Softwaresuche 18

4.2 Zusatzprogramme 19

Import 20



Einleitung

Dieses Dokument beschreibt eine Methode zur Inventarisierung von IT-Systemen, die sich nicht bzw. nur unregelmäßig im Netzwerk befinden, beispielsweise Laptops von Außendienstmitarbeitern. Wenn es sich um Windows-Systeme handelt, empfiehlt sich hierfür der Einsatz der DocusnapScript.exe.

Auch für Linux-Systeme, Mac-Systeme und Exchange-Server existieren entsprechende Skripte, welche in eigenen Support-Dokumenten behandelt werden.

In diesem Dokument wird die Einbindung der DocusnapScript.exe mittels zentraler Bereitstellung über Gruppenrichtlinien und einer manuellen Ausführung beschrieben.

Anschließend wird der interaktive und automatisierte Import der Scanergebnisse in die Docusnap Datenbank gezeigt.



Grundlagen

2.1 Speicherort

Die DocusnapScript.exe wird bei der Installation von Docusnap im Anwendungsverzeichnis - im Ordner Tools abgelegt. Dieser Ordner kann über die Benutzeroberfläche von Docusnap aufgerufen werden.

- C:\Program Files\Docusnap\Tools - C:\Program Files (x86)\Docusnap\Tools

Abbildung 1 - Aufruf des Verzeichnisses über Docusnap 2.2 Funktion

DocusnapScript.exe erzeugt beim Aufruf eine XML-Datei, in welcher alle Inventarisierungsinformationen des lokalen Systems enthalten sind. Diese XML-Datei kann in weiterer Folge in Docusnap importiert werden.

Zum Ausführen der DocusnapScript.exe genügen Benutzerrechte auf dem jeweiligen System.

Weitere Informationen bezüglich dem Import der XML-Datei sind dem Kapitel IMPORT zu entnehmen.



2.3 Automatisierung

Es besteht zusätzlich die Möglichkeit DocusnapScript.exe automatisiert auszuführen. Die erzeugten XML-Dateien können über Parameter auf einer zentralen Netzwerk-Freigabe abgelegt und anschließend über den Docusnap Server automatisiert und zu festgelegten Zeiten importiert werden.

Windows Systeme

Linux Systeme

Inventardaten (XML)

Speicherung der Inventardaten (XML)

Zentrale Freigabe

Docusnap Server Dienst

Zeitgesteuerter Import in die Docusnap Datenbank

Abbildung 2 - Ablauf automatischer Import

Die DocusnapScript.exe wird bei einer Ausführung während der Anmeldung eines Benutzers (z.B. durch eine Gruppenrichtlinie) mit den Rechten des anmeldenden Benutzers ausgeführt. Benutzer müssen daher

berechtigt sein, auf die zentrale Netzwerk-Freigabe zu schreiben.

2.4 Benötigte Rechte

Für den Aufruf der DocusnapScript.exe zur Inventarisierung des lokalen Systems sind Benutzerrechte ausreichend.

Bitte beachten Sie, dass für die Inventarisierung von BitLocker-Informationen die DocusnapScript.exe mit

administrativen Rechten ausgeführt werden muss.



2.5 Parameter

Die möglichen Übergabeparameter können über den Aufruf von DocusnapScript.exe -? aufgerufen werden.

Abbildung 3 - Docusnap Script Parameter

Folgendes Beispiel inventarisiert das System und legt die .XML Datei auf der zentralen Netzwerk-Freigabe \\SMDC0001\DC-Share ab: DocusnapScript.exe –O \\SMDC0001\DC-Share\



2.6 Docusnap Script Legacy

Die DocusnapScript.exe kann nicht genutzt werden, um Windows Systeme mit folgenden Betriebssystemen manuell zu inventarisieren:

• Windows XP • Windows Server 2000 • Windows Server 2003

Damit Windows Systeme mit den zuvor aufgeführten Betriebssystemen manuell inventarisiert werden können, muss die DocusnapScriptLegacy.exe genutzt werden. Die DocusnapScriptLegacy.exe ist ebenfalls im Programmverzeichnis von Docusnap - Unterordner Tools zu finden.

- C:\Program Files\Docusnap\Tools - C:\Program Files (x86)\Docusnap\Tools



Zentrale Ausführung

3.1 Vorbereitungen

Eine besonders effektive Variante zum Verteilen von Logonscripts ist die Verwendung von Gruppenrichtlinienobjekten (GPO). Dies kann je nach Anforderung an die Inventarisierung als Benutzer- oder Computerkonfiguration erfolgen.

Die DocusnapScript.exe kann hierbei unter \\%userdomain%\netlogon bereitgestellt werden. Die Active Directory-Replikation übernimmt dann die Verteilung der DocusnapScript.exe auf weitere Domänencontroller in der Infrastruktur.

Je nach Active Directory-Infrastruktur kann die Verteilung von Gruppenrichtlinien und Logonscripts eine Zeit lang (meist innerhalb von 15 Minuten) dauern.

Für die Ablage der XML-Dateien muss ein zentraler Ablagepfad bereitgestellt werden, auf den alle Benutzer bzw. Computer zum Ablegen der XML Dateien berechtigt sind.

3.2 Die Verwaltungskonsole (GPMC)

Die nachfolgenden Beispiele werden mit dem Microsoft Tool Gruppenrichtlinien-Verwaltungskonsole (GPMC) durchgeführt.

Sofern die Gruppenrichtlinien-Verwaltungskonsole nicht bereits installiert ist, kann diese kostenlos bei Microsoft heruntergeladen werden. Ein vorheriger Test in einer Testumgebung oder der Einsatz der Einstellungen nur auf eine spezielle Test- Organisationsebene (OU) im Active Directory wird dringend empfohlen.

Die Remoteserver-Verwaltungstools, welche die GPMC enthalten, können für die Windows Client-Betriebssysteme bei Microsoft heruntergeladen werden.

Bei Windows Server-Betriebssystemen (ab 2008) ist die GPMC bereits enthalten, muss aber gegebenenfalls über den Server-Manager nachinstalliert werden.



3.3 GPMC starten

Die Gruppenrichtlinien-Verwaltungskonsole kann über den Windows-Ausführen-Dialog (Windows-Taste+R) und die Eingabe von gpmc.msc gestartet werden.

Abbildung 4 - Gruppenrichtlinienverwaltung



3.4 Einbindung mittels parametrisierter GPO

Schritt 1: Rechtsklick auf das gewünschte Gruppenrichtlinienobjekt und bearbeiten

Schritt 2: Benutzerkonfiguration / Computerkonfiguration => Windows-Einstellungen => Skripts

Schritt 3: Doppelklick auf An- oder Abmelden bzw. Starten oder Herunterfahren

Schritt 4: Hinzufügen eines neuen Skripts und Daten angeben

Skriptname: \\%userdomain%\netlogon\DocusnapScript.exe Skriptparameter: -o \\UNC-Pfad

Abbildung 5 – Einbindung DocusnapScript.exe mittels GPO



Schritt 5:

Abbildung 6 - Sicherheitsfilterung beachten

Achten Sie darauf, dass die entsprechenden Benutzer oder Gruppen in der Sicherheitsfilterung gewählt sind.

Bitte prüfen Sie zusätzlich im Tab Delegierung, welche Benutzer und Gruppen Berechtigungen für dieses Gruppenrichtlinienobjekt besitzen.



3.5 Einbindung mittels VB-Skript

Schritt 1: Rechtsklick auf das gewünschte Gruppenrichtlinienobjekt und bearbeiten

Schritt 2: Benutzerkonfiguration / Computerkonfiguration => Windows-Einstellungen => Skripts

Schritt 3: Doppelklick auf An- oder Abmelden bzw. Starten oder Herunterfahren

Schritt 4: Hinzufügen eines neuen Skripts und Daten angeben

Skriptname: \\%userdomain%\netlogon\DS-Script.vbs

Abbildung 7 - Einbindung mittels VB-Skript Beispiel für DS-Script.vbs:

on error resume next Set WshShell = WScript.CreateObject(“WScript.Shell”) WshShell.Run “\\DOCUSNAP\Netlogon\DocusnapScript.exe -o \\SMDC0001\Public\DS-Script”



Schritt 5:

Abbildung 8 - Sicherheitsfilterung beachten

Achten Sie darauf, dass die entsprechenden Benutzer oder Gruppen in der Sicherheitsfilterung gewählt sind.

Bitte prüfen Sie zusätzlich im Tab Delegierung, welche Benutzer und Gruppen Berechtigungen für dieses Gruppenrichtlinienobjekt besitzen.



3.6 Verwendung eines WMI-Filters

3.6.1 Erstellung

Gegebenenfalls kann es notwendig sein, die Gültigkeit eines Gruppenrichtlinienobjektes unabhängig von der Zuordnung zu einer OU einzuschränken, beispielsweise wenn Computerkonten im Active Directory über viele OUs verteilt sind und nur bestimmte Geräte mittels Docusnap Script inventarisiert werden sollen.

Im Folgenden wird beschrieben, wie dies mittels eines WMI-Filters realisierbar ist:

Schritt 1: Mittels Rechtsklick auf den Knoten WMI-Filter kann in der Gruppenrichtlinienverwaltung ein neuer Filter angelegt werden.

Schritt 2: Geben Sie diesem einen „sprechenden“ Namen.

Schritt 3: Fügen Sie dem Namespace root\CIMv2 die entsprechende Abfrage hinzu

Abbildung 9 - Gruppenrichtlinienverwaltung



Beispiel für WMI-Abfrage:

Select * from Win32_OperatingSystem where ProductType = 1 and not CSName like “WMWS%“

Diese Abfrage wählt alle Clients deren Namen mit WMWS beginnen

Die Variable „ProductType“ liefert folgende Werte zurück:

1 = Microsoft Windows Client-Betriebssysteme (z. B. Windows 7, Windows 8) 2 = Microsoft Windows Server-Betriebssysteme, die als Domaincontroller konfiguriert sind 3 = Microsoft Windows Server-Betriebssysteme, die nicht als Domaincontroller konfiguriert sind

3.6.2 Zuweisung

Weisen Sie der Gruppenrichtlinie, welche die DocusnapScript.exe aufruft, den neuen erstellten WMI-Filter zu.

Abbildung 10 – Zuweisung WMI-Filter



Die Zuweisung ist auch vom WMI-Filter aus sichtbar.

Abbildung 11 - WMI-Filter

Manuelle Ausführung

Die manuelle Ausführung der DocusnapScript.exe kann bei isolierten Systemen, welche nicht an das Netzwerk angeschlossen sind, sinnvoll sein. Ebenso ist ein Einsatz bei Systemen denkbar, wo sich Probleme beim Netzwerkzugriff (z.B. wegen Firewall-Einstellungen, WMI-Zugriffsproblemen, usw.) nicht oder nicht kurzfristig lösen lassen. In diesen Fällen können die erzeugten XML-Dateien auch per USB-Stick ins Netzwerk transportiert und dort manuell oder automatisch (wenn die Dateien in den zentralen Import-Share kopiert werden) importiert werden.

Auf dem zu inventarisierenden System muss lediglich die Datei DocusnapScript.exe ausgeführt werden. Standardmäßig wird die XML-Datei in dem Ordner abgelegt, in dem auch die DocusnapScript.exe gespeichert und ausgeführt wurde.

Die möglichen Inventarisierungsparameter bei der manuellen Ausführung sind im Kapitel 2.5 - PARAMETER nachzulesen.

4.1 Softwaresuche

Mit Hilfe der Softwaresuche bietet Docusnap ein zusätzliches Feature an, um Softwareprodukte zu inventarisieren, welche nicht über die Windows-Inventarisierung erfasst werden können. Die Softwaresuche kann auch bei der Ausführung des Docusnap-Skriptes verwendet werden. Um die Softwaresuche verwenden zu können, muss eine XML Softwareliste manuell erstellt werden.

Die XML Datei hat folgenden Aufbau:

<SoftwareItem> <SoftwareName>Notepad</SoftwareName> <SoftwarePublisher>Microsoft</SoftwarePublisher>  <SoftwareVersion>1.0</SoftwareVersion>  <FileName>notepad.exe</FileName> <SearchPath>C:\Windows</SearchPath> <FileSize>193536</FileSize>  <ModifyDate>01.01.2018</ModifyDate> 

</SoftwareItem>

Der Dateiname muss korrekt angegeben werden oder mittels Wildcards (?,*) gesetzt werden.

<SoftwareItem> <SoftwareName>Notepad</SoftwareName> <SoftwarePublisher />  <SoftwareVersion />  <FileName>notepad.exe</FileName> <SearchPath>C:\Windows</SearchPath> <FileSize />  <ModifyDate /> 

</SoftwareItem>

Wird einer der optionalen Bereiche nicht angegeben, so muss die Schreibweise wie im Beispiel oben angegeben werden (<SoftwarePublisher />).

Wird eine falsche Dateigröße angegeben, so wird die gewünschte Software nicht ausgelesen!



Der Aufruf der Softwareliste in Docusnap Script erfolgt mit folgendem Aufruf:

DocusnapScript.exe -S <Pfad\><Dateiname.xml>

4.2 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 Docusnap Script 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.



Import

Über den Skript Import können die erstellten XML-Dateien in Docusnap importiert werden.

Der Assistent für den Import ist über die Benutzeroberfläche Inventar > Andere Quellen > Aus DocusnapScript.exe zu finden.

Abbildung 12 - Aufruf des Importassistenten

Im ersten Schritt sind eine Firma und eine Domäne für den Import auszuwählen. Anschließend ist der entsprechende Pfad anzugeben, in dem die XML-Dateien abgelegt wurden.

Abbildung 13 – XML Import

Geben Sie hier bitte das Verzeichnis bzw. den UNC-Pfad der zentralen Freigabe an, aus der die XML-Dateien importiert werden sollen. Wenn Sie den automatischen Import planen, ist es wichtig, dass der Benutzer mit dem der Docusnap Server Dienst konfiguriert wurde, Lese- und Schreibzugriff auf das angegebene Verzeichnis besitzt.



Im nächsten Schritt muss der Button „Suche nach Dateien“ ausgewählt werden. Nun wird der angegebene Ordner nach XML-Ergebnisdateien durchsucht. Ergebnisdateien sämtlicher skriptbasierten Inventarisierungsmöglichkeiten würden erkannt und ausgewählt werden (Windows, Linux, Mac, Exchange).

Abbildung 14 - Dateiauswahl der XML-Ergebnisdateien

Abbildung 15 - Zeitplanung automatischer Import

Unter „Zeitplanung“ kann dieser Import als Auftrag geplant werden, sodass die erzeugten XML-Dateien

regelmäßig zu festgelegten Zeiten importiert werden. Voraussetzung hierfür ist, dass der Docusnap Server konfiguriert wurde. Siehe hierzu im Benutzerhandbuch

unter https://www.docusnap.com/hilfe/docusnap-x/anwender/docusnap-server.html

Es ist nicht möglich XML Dateien, welche mit Docusnap Script 6.3 oder älter erstellt wurden, in Docusnap X zu importieren!

https://www.docusnap.com/hilfe/docusnap-x/anwender/docusnap-server.html



ABBILDUNGSVERZEICHNIS

ABBILDUNG 1 - AUFRUF DES VERZEICHNISSES ÜBER DOCUSNAP .................................................................................................... 5 ABBILDUNG 2 - ABLAUF AUTOMATISCHER IMPORT .............................................................................................................................. 6 ABBILDUNG 3 - DOCUSNAP SCRIPT PARAMETER ................................................................................................................................... 7

ABBILDUNG 4 - GRUPPENRICHTLINIENVERWALTUNG .........................................................................................................................10

ABBILDUNG 5 – EINBINDUNG DOCUSNAPSCRIPT.EXE MITTELS GPO ............................................................................................. 11

ABBILDUNG 6 - SICHERHEITSFILTERUNG BEACHTEN ............................................................................................................................12

ABBILDUNG 7 - EINBINDUNG MITTELS VB-SKRIPT .................................................................................................................................13

ABBILDUNG 8 - SICHERHEITSFILTERUNG BEACHTEN ........................................................................................................................... 14 ABBILDUNG 9 - GRUPPENRICHTLINIENVERWALTUNG..........................................................................................................................15

ABBILDUNG 10 – ZUWEISUNG WMI-FILTER ...............................................................................................................................................16

ABBILDUNG 11 - WMI-FILTER .......................................................................................................................................................................... 17

ABBILDUNG 12 - AUFRUF DES IMPORTASSISTENTEN ........................................................................................................................... 20

ABBILDUNG 13 – XML IMPORT ...................................................................................................................................................................... 20

ABBILDUNG 14 - DATEIAUSWAHL DER XML-ERGEBNISDATEIEN .......................................................................................................21 ABBILDUNG 15 - ZEITPLANUNG AUTOMATISCHER IMPORT ...............................................................................................................21

[email protected] | www.docusnap.com/support © itelio GmbH - www.itelio.com

VERSIONSHISTORIE

Datum Beschreibung

25.04.2017 Version 1.0 fertiggestellt

24.10.2018 Version 1.1 – Austausch veralteter Screenshots, Erweiterung um Punkte Softwaresuche und Zusatzprogramme, Links aktualisiert

Docusnap X - Docusnap Script Windows · This document contains proprietary information and may not...

Documents

Transcript of Docusnap X - Docusnap Script Windows · This document contains proprietary information and may not...