Quelltext der Seite ZnilTools:ifmemberDELUXE.exe

[[Kategorie:Anmeldeskripte]]
'''<u>Changelog:</u>'''
* 2011 erste Version
* 2022 Überarbeitung
* 01.03.2023 Version 1.2.0.2 - Cache Mode + Standarddrucker setzen
* 21.07.2023 Version 1.2.0.6 - kleinere Korrekturen / Fehler in der Hilfe (/CacheList) / Rechtschreibfehler
* 14.08.2023 Version 1.2.0.23 - Schalter für persistentes Mounten + Mounten des Homelaufwerkes
----
[[Datei:Ifmemberdeluxe_logo.png|link=ZnilTools:ifmemberDELUXE.exe]]<br>
----
===Aktuellste Version===
'''Download neueste Version:''' <big>[[Media:IfMemberDeluxe V1.2.0.23.zip|IfMemberDeluxe V1.2.0.23.zip]]</big> (Version 1.2.0.6)<br>
Download vorherige Version: [[Media:IfMemberDeluxe_V1.2.0.6.zip|IfMemberDeluxe_V1.2.0.6.zip]] (Version 1.2.0.6)<br>
Download vorherige Version: [[Media:IfMemberDeluxe_V1.2.0.2.zip|IfMemberDeluxe_V1.2.0.2.zip]] (Version 1.2.0.2)<br>
Download vorherige Version: [[Media:IfMemberDeluxe.zip|IfMemberDeluxe.zip]] (Version 1.0.2.9)<br>
Getestet unter: Windows XP, Windows Server 2003, Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012 R2, Windows Server 2016, Windows Server 2019<br>
<br>
Fehler oder Anregungen bitte an: Bernhard@znil.de<br>
<br>
Wer mit diesem Tools sein Ziel nicht erreicht findet eventuell mit '''[[ZnilTools:ifmemberexecute.exe|ifmemberexecute.exe]]''' was er sucht!<br>
<br>
----
Stichwörter: ifmember deluxe ifmember.exe deluxe ismember deluxe ismember.exe deluxe
----
<br>

===Beschreibung===
ifmemberDELUXE.exe ist eine Erweiterung der bekannten Programme '''''ifmember.exe''''' und '''''ismember.exe'''''. <br>
Mehr zu diesen beiden "Originalen" findet Ihr unter [[Windows:ifmember+ismember|AD-Gruppenmitgliedschaft in Batchdateien auswerten - ifmember.exe oder ismember.exe]]<br>
<br>
Es verbindet in Abhängigkeit von Gruppenmitgliedschaften Netzlaufwerke und Netzwerkdrucker. Es ist für den Einsatz in Anmeldescripten in Active Directory Domänen gedacht. 
<br>
<br>
<u>IfmemberDELUXE.exe bietet zur Zeit folgende Funktionen:</u><br>
* prüfen ob ein Benutzer direkt oder indirekt (verschachtelte Gruppen) Mitglied einer Gruppe ist
* Verbinden von Netzlaufwerken mit Wahl des Laufwerksbuchstaben
* Setzen der Bezeichnung für das Netzlaufwerk (Anzeigename)
* Verbinden von Netzwerkdruckern:
** Ohne Prüfung des Betriebssystems
** Mit Prüfung ob es ein x86 (32Bit) oder x64 (64Bit) System ist - und Auswahl des passenden Printservers
** es wird kein Fenster beim Verbinden eingeblendet wie bei anderen Methoden
** Setzen des Standarddruckers
* Chaching Modus
** Per Aufruf werden die Mitgliedschaften in der Registry zwischengespeichert
** Für Skripte mit vielen Aufrufen
** Erhöht die Abarbeitung um ca. 50%
* Persistenz
** per einmaligen Aufruf mit dem Parameter <code>/PERSISTENT:YES</code> bleiben die Netzlaufwerke dauerhaft verbunden
* Homelaufwerk
** per Schalter <code>/MAPHOMEDRIVE</code> wird das im Active Directory hinterlegte Homelaufwerk gemappt
<br>
<br>
----
----

===Anleitung===
Vorweg: Ihr solltet in euren Scripten / Batch-Dateien entweder den vollständigen Pfad zur '''''ifmemberdeluxe.exe''''' angeben, oder die Datei in das gleiche Verzeichnis legen.<br>
Umlaute funktionieren zwar, die Verwendung erfolgt aber auf eigene Gefahr.<br>
Bei Leerzeichen in den Namen oder Pfaden diese bitte in '''" "''' setzen (Gänsefüsschen oben, {{key|SHIFT}} + {{key|2}})<br>
<br>
Die eingebaute Hilfe erreicht ihr über den Aufruf von IfMemberDeluxe.exe ohne Parameter oder über<br>
 IfMemberDeluxe.exe /?
<br>
<br>
----
====Verbinden von Netzlaufwerken====
<br>
Aufruf für Netzlaufwerk mappen: (Allgemein)
 IfMemberDeluxe.exe [Gruppenname] [Laufwerksbuchstabe:] [UNC-Pfad-Netzlaufwerk]
<br>
Aufruf für Netzlaufwerk mappen: (mit Label / Bezeichnung)
 IfMemberDeluxe.exe [Gruppenname] [Laufwerksbuchstabe:] [Label]:[UNC-Pfad-Netzlaufwerk]
<br>
Parameter:
 [Gruppenname]                 : Name der zu prüfenden Gruppe
 [Laufwerksbuchstabe:]         : Buchstabe der für das Mapping verwendet werden
                                 soll
 [Label]                       : Bezeichnung für das Netzlaufwerk falls gewünscht
<br>
<br>
<u>'''Beispiel 1:'''</u> Laufwerk verbinden<br>
Wenn der Benutzer Mitglied der Gruppe '''''Buchhaltung''''' ist soll '''''N:''''' mit '''''\\FILESERVER\Buchhaltung''''' verbunden werden<br>
 ifmemberdeluxe.exe Buchhaltung N: \\FILESERVER\Buchhaltung
Ergebnis: [[Datei:IfMemberDeluxe-001.gif]]
<br>
<br>
<u>'''Beispiel 2:'''</u> Laufwerk verbinden und eigene Bezeichnung vergeben<br>
Wenn der Benutzer Mitglied der Gruppe '''''Buchhaltung''''' ist soll '''''N:''''' mit '''''\\FILESERVER\Buchhaltung''''' verbunden werden und '''''Buchhaltung''''' als Label gesetzt werden<br>
 ifmemberdeluxe.exe Buchhaltung N: Buchhaltung:\\FILESERVER\Buchhaltung
Ergebnis: [[Datei:IfMemberDeluxe-002.gif]]
<br>
<br>
<u>'''Beispiel 3:'''</u> Verwendung von Leerzeichen im Gruppennamen und Bezeichnung<br>
Wenn der Benutzer Mitglied der Gruppe '''''Unsere Buchhaltung''''' ist soll '''''N:''''' mit '''''\\FILESERVER\Buchhaltung''''' verbunden werden und '''''Buchhaltung - nur Dokumente''''' als Label gesetzt werden<br>
 ifmemberdeluxe.exe "Unsere Buchhaltung" N: "Buchhaltung - nur Dokumente":\\FILESERVER\Buchhaltung
Ergebnis: [[Datei:IfMemberDeluxe-003.gif]]
<br>
<br>
<br>
<br>
----
====Verbinden von Netzwerkdruckern (32 und 64Bit)====
<br>
Aufruf für Netzwerkdrucker mappen: (Allgemein)
 IfMemberDeluxe.exe [Gruppenname] [UNC-Pfad-Drucker]
<br>
Aufruf für Netzwerkdrucker mappen Betriebssystemabhängig: (32/64Bit)
 IfMemberDeluxe.exe [Gruppenname] x86:[UNC-Pfad-Drucker]
 IfMemberDeluxe.exe [Gruppenname] x64:[UNC-Pfad-Drucker]
<br>
Aufruf für Netzwerkdrucker mappen und als Standarddrucker setzen:
 IfMemberDeluxe.exe [Gruppenname] Default:[UNC-Pfad-Drucker]
 IfMemberDeluxe.exe [Gruppenname] Defaultx86:[UNC-Pfad-Drucker]
 IfMemberDeluxe.exe [Gruppenname] Defaultx64:[UNC-Pfad-Drucker]

Parameter
 [Gruppenname]                  : Name der zu prüfenden Gruppe
 [UNC-Pfad-Netzlaufwerk]        : Pfad zu Dateiserver / Freigabe für Netzlaufwerk
 [UNC-Pfad-Drucker]             : Pfad zu Druckserver / Freigabename Drucker
 x86:[UNC-Pfad-Drucker]         : Pfad zu Druckerserver mit 32Bit Druckertreiber
 x64:[UNC-Pfad-Drucker]         : Pfad zu Druckerserver mit 64Bit Druckertreiber
 Default:[UNC-Pfad-Drucker]     : Pfad zu Druckserver / Freigabename Drucker
 Default:x86:[UNC-Pfad-Drucker] : Pfad zu Druckerserver mit 32Bit Druckertreiber
 Default:x64:[UNC-Pfad-Drucker] : Pfad zu Druckerserver mit 64Bit Druckertreiber
<br>
<br>
<u>'''Beispiel 1:'''</u> Drucker verbinden<br>
Wenn der Benutzer Mitglied der Gruppe '''''Raum103''''' ist soll der Drucker '''''\\Printserver\Etage1''''' verbunden werden<br>
 ifmemberdeluxe.exe Raum103 \\Printserver\Etage1
<br>
<br>
<u>'''Beispiel 2:'''</u> Drucker verbinden wenn der Computer ein 32Bit Betriebssystem hat<br>
Wenn der Benutzer Mitglied der Gruppe '''''Raum103''''' ist und der Computer ein 32Bit Betriebssystem hat, soll der Drucker '''''\\Printserver32Bit\Etage1''''' verbunden werden<br>
 ifmemberdeluxe.exe Raum103 x86:\\Printserver32Bit\Etage1
<br>
<br>
<u>'''Beispiel 3:'''</u> Drucker verbinden wenn der Computer ein 64Bit Betriebssystem hat<br>
Wenn der Benutzer Mitglied der Gruppe '''''Raum103''''' ist und der Computer ein 64Bit Betriebssystem hat, soll der Drucker '''''\\Printserver64Bit\Etage1''''' verbunden werden<br>
 ifmemberdeluxe.exe Raum103 x64:\\Printserver64Bit\Etage1
<br>
<br>
<u>'''Beispiel 4:'''</u> Aufruf in einem Anmeldescript mit 32 und 64Bit Druckertreiber<br>
Wenn der Benutzer Mitglied der Gruppe '''''Raum103''''' ist soll der Drucker '''''\\Printserver64Bit\Etage1''''' verbunden werden -> mit den passenden Printerserver<br>
 ifmemberdeluxe.exe Raum103 x86:\\Printserver32Bit\Etage1
 ifmemberdeluxe.exe Raum103 x64:\\Printserver64Bit\Etage1
Der Drucker ist auf 2 Printserver frei gegeben, jeweils unter dem Namen '''''Etage1'''''. Nur einer der beiden Befehle ist erfolgreich
<br>
<br>
<u>'''Beispiel 5:'''</u> Drucker verbinden und als Standarddrucker setzen<br>
Wenn der Benutzer Mitglied der Gruppe '''''Raum103''''' ist soll der Drucker '''''\\Printserver\Etage1''''' verbunden und als Standard gesetzt werden<br>
 ifmemberdeluxe.exe Raum103 Default:\\Printserver\Etage1
<br>
<br>
<br>
----

===Testfunktionen===
====Auflisten aller Gruppenmitgliedschaften====
Auflisten aller Gruppenmitgliedschaften:
 IfMemberDeluxe.exe /Liste
Beispiel:<br>
[[Datei:IfMemberDeluxe-004.gif]]
<br>
<br>
<br>
<br>
====Test Betriebssystem auf 32/64Bit====
Test Betriebssystem auf 32/64Bit
 IfMemberDeluxe.exe /OS
Beispiel:<br>
[[Datei:IfMemberDeluxe-005.gif]]
<br>
<br>
<br>
<br>
----
===Caching / Tuning der Geschwindigkeit / Performance===
Generell dauert die erste Abfrage der Gruppenmitgliedschaften etwas "länger" als alle nachfolgenden Abfragen.<br>
Wenn es dann noch immer zulange dauert findet unten stehend den Cache-Mode der mit Version 1.0.2.9 eigenführt wurde.<br>
Wird beim Druckermapping die Funktion der 32/64Bit Abfrage genutzt, so kostet auch diese Zeit. Auch hier wiederum beim ersten mal etwas länger als danach, jedoch ist die Verzögerung jedes Mal zu erkennen.
<br>
Werden viele Laufwerke und Drucker gemappt bzw. geprüft kann die Abfrage der Gruppenmitgliedschaften gecached werden:
 Caching-Befehle:
 ----------------
 Dies kann bei vielen Mappings eine Beschleunigung von ca. 50%
  bringen (gemessen mit 142 Laufwerken und 128 Druckern)
 
 IfMemberDeluxe.exe /CacheCreate
  ---> Ermittelt die Gruppenmitgliedschaften und speichert diese in der Registry
       Werden diese Einträge beim Programmstart gefunden so werden
       diese statt der AD-Abfrage verwendet.
 
 IfMemberDeluxe.exe /CacheList
  ---> Liest den Cache aus und listet alle Gruppen auf in denen der Benutzer
       Mitglied ist.
 
 IfMemberDeluxe.exe /CacheDelete
  ---> Löscht die Caching-Einträge wieder aus der Registry
 
<br>
<u>'''Beispiel für Caching:'''</u><br>
<source lang="DOS">
REM Pfad zu IfMemberDeluxe setzen
set IFMEMBER="\\znil.local\NETLOGON\Tools\IfMemberDeluxe.exe"
REM Beim Start des Skriptes Cache anlegen:
%IFMEMBER% /CacheCreate
REM Laufwerke mappen
%IFMEMBER% Laufwerk-EG-G-R* G: Erdgeschoss:\\FILE01\EG
%IFMEMBER% Laufwerk-OG-G-R* G: Obergeschoss:\\FILE01\OG
REM Drucker mappen
%IFMEMBER% Drucker-EG \\PRINT01\Drucker-EG
%IFMEMBER% Drucker-OG Default:\\PRINT01\Drucker-OG
REM Cache wieder löschen (nicht unbedingt notwendig, jedes /CacheCreate löscht die vorhandenen Einträge zuvor)
%IFMEMBER% /CacheDelete
</source>
<br>
<br>
----

===Ausgaben unterdrücken===
Setzt man an den Anfang des Anmeldeskriptes ein
 set BQUIET=TRUE
so werden - bis auf Fehlermeldungen - alle Textausgaben von IfMemberDeluxe unterbunden.
<br>
<br>
----
==Laufwerke persistent mappen==
'''Beispiel:'''<br>
 \\znil.local\NETLOGON\Tools\IfMemberDeluxe.exe /PERSISTENT:YES
einmal an den Anfang des Anmeldeskriptes setzten. Danach werden alle Netzlaufwerke persistent gesetzt, sind also auch nach einer Ab- und Anmeldung noch vorhanden.<br>
IfMemberDeluxe.exe prüft bei der nächsten Anmeldung ob die Pfade stimmen und korrigiert diese ggf.<br>
<br>
<br>
----
==Homelaufwerk mappen==
 \\znil.local\NETLOGON\Tools\IfMemberDeluxe.exe /MAPHOMEDRIVE
prüft ob im Active Directory für den Benutzer ein Benutzerlaufwerk gesetzt ist (Reiter Profil) und verbindet das Laufwerk mit den dortigen Daten.<br>
Falls das Laufwerk schon verbunden ist, der UNC-Pfad aber unterschiedlich ist wird das Laufwerk getrennt und korrekt wieder verbunden.
<br>
<br>
----
===Einschränkungen===
Ich habe es zwar noch nicht getestet - aber auch IfMemberDELUXE.exe wird von einen Fehler bei den Gruppenabfragen betroffen sein.<br>
Das bedeutet, das bei mehr als 1.000 Gruppen die Abfrage ggf. nur die ersten 1.000 zurückmelden wird - das Problem sollte also eher selten auftreten.<br>
<br>
<br>
---

===Kommentare===
<comments />