Hilfsprogramm remoteIC.exe

remoteIC.exe biete eine vielzahl von nⁿtzlichen Funktionen welche Sie in den Softwarepaketen verwenden k÷nnen. Da remoteIC.exe auf jedem Client im remoteIC Netzwerk installiert ist, k÷nnen Sie remoteIC.exe ohne weitere Anforderungen verwenden.

remoteIC.exe [Funktion] [Parameter 1] [Parameter 2] ...

Nachfolgend finden Sie eine Beschreibung zu den einzelnen Funktionen.


remoteIC.exe service

Startet den remoteIC service.


remoteIC.exe installService serviceName [/DSN] [/SYS] [/TRS] [/c:] [/d:] [/f:] [/l:] [/p:] [/s:] [/u:] [/w:]

Mit installService k÷nnen Dienste installiert werden. Es sind Administratorenrechte erforderlich.

Parameter Beschreibung
serviceName Kurzname des Dienstes
/c: Computername (falls nicht lokal)
/d: Angezeigter Name des Dienstes
/f: Dateipfad (Bsp: c:\winnt\system32\remoteIC.exe)
/l: Datenbank Login (nur bei remoteIC)
/p: Windows Passwort
/s: Datenbank Servername (nur bei remoteIC)
/u: Windows Benutzerkonto (Bsp. DomΣne\Benutzer1)
/w: Datenbank Passwort (nur bei remoteIC)
/DSN Der remoteIC DNS wird erstellt (nur bei remoteIC)
/SYS Der Dienst wird unter dem Lokalen Systemkonto gestartet
/TRS Verwende Windows NT-Autentifizierung (nur bei remoteIC)

Beispiel: remoteIC.exe installService remoteIC /d:"Remote installation center" /f:c:\winnt\system32\remoteIC.exe /u:DOMAIN\Username /p: mypassword /SYS /TRS


remoteIC.exe uninstallService serviceName [/c:]

Mit uninstallService k÷nnen Dienste entfernt werden. Es sind Administratorenrechte erforderlich.

Parameter Beschreibung
serviceName Kurzname des Dienstes
/c: Computername (falls nicht lokal)

Beispiel: remoteIC.exe uninstallService remoteIC


remoteIC.exe startService serviceName [computerName]

Startet einen Dienst.

Parameter Beschreibung
serviceName Name vom Dienst (Kurzbezeichnung)
computerName Computername wenn der Dienst nicht auf dem lokalen Computer gestartet werden soll.

Beispiel: remoteIC.exe startService remoteic testpc


remoteIC.exe stopService serviceName [computerName]

Stoppt einen Dienst.

Parameter Beschreibung
serviceName Name vom Dienst (Kurzbezeichnung)
computerName Computername wenn der Dienst nicht auf dem lokalen Computer gestoppt werden soll.

Beispiel: remoteIC.exe stopService remoteic testpc


remoteIC.exe queryService serviceName [computerName]

Fragt den Status von einem Dienst ab.

Parameter Beschreibung
serviceName Name vom Dienst (Kurzbezeichnung)
computerName Computername wenn der Status von einem sich nicht auf dem lokalen Computer befindenden Dienst abgefragt werden soll.

Beispiel: remoteIC.exe queryService remoteic testpc


remoteIC.exe setStatus installationStatus

Parameter Beschreibung
installationStatus 0: Paket erfolgreich installiert/entfernt
1: Paket fehlgeschlagen
2: Anforderung nicht erfⁿllt
3: Neustart innerhalb von Paket

Beispiel: remoteIC setStatus 0


remoteIC.exe sleep ms

Wartet fⁿr eine in Millisekunden angegebene Dauer.

Parameter Beschreibung
ms Wartezeit in Millisekunden

Beispiel: remoteIC.exe sleep 500


remoteIC.exe waitForProcess process [timeout]

Wartet bis ein bestimmter Prozess gestartet wird.

Parameter Beschreibung
process Prozessname oder Prozessnummerr
timeout Timeout in Sekunden

Beispiel: remoteIC.exe waitForProcess explorer.exe 10


remoteIC.exe waitForEndProcess process [timeout]

Wartet bis ein Prozess gestoppt worden ist.

Parameter Beschreibung
process Prozessname oder -nummer
timeout Timeout in Sekunden

Beispiel: remoteIC.exe waitForEndProcess explorer.exe 10


remoteIC.exe killProcess process

Beendet einen laufenden Prozess.

Parameter Beschreibung
process Prozessname oder -nummer

Beispiel: remoteIC.exe killProcess 1080


remoteIC.exe listProcess

Listet die aktuell aktiven Prozesse auf.


remoteIC.exe setReg rootKey key valueName [/hex:]data [dataType] [computer]

Setzt einen Registrierungseintrag.

Parameter Beschreibung
rootKey HKLM: HKEY_LOCAL_MACHINE
HKCU: HKEY_CURRENT_USER
HKCR: HKEY_CLASSES_ROOT
HKU: HKEY_USERS
HKCC: HKEY_CURRENT_CONFIG
key Kompletter Registrierungsschlⁿssel unter dem ausgewΣhlten rootKey
valueName Wert welcher geΣndert oder hinzugefⁿgt werden soll
/hex: Die gelieferten Daten sind im Hexadezimalformat (ohne AbstΣnde)
data Neuer Wert
dataType Einer der folgenden Werte: REG_SZ, REG_DWORD, REG_EXPAND_SZ, REG_MULTI_SZ, REG_BINARY
computer Computername wenn der Registrierungseintrag nicht auf dem lokalen Computer geΣndert werden soll.

Beispiele:
remoteIC.exe setReg HKLM Software\testKey timeout 25 REG_DWORD
remoteIC.exe setReg HKLM Software\testKey timeout 25 REG_DWORD \\REMOTEPC
remoteIC.exe setReg HKLM Software\testKey "reg schlⁿssel" "reg wert" REG_SZ
remoteIC.exe setReg HKLM Software\testKey "reg schlⁿssel" "/hex:B01610" REG_BINARY


remoteIC.exe getReg rootKey key valueName [computer]

Gibt den Wert eines Registrierungseintrags aus.

Parameter Beschreibung
rootKey HKLM: HKEY_LOCAL_MACHINE
HKCU: HKEY_CURRENT_USER
HKCR: HKEY_CLASSES_ROOT
HKU: HKEY_USERS
HKCC: HKEY_CURRENT_CONFIG
key Kompletter Registrierungsschlⁿssel unter dem ausgewΣhlten rootKey
valueName Wert welcher angezeigt werden soll
computer Computername wenn nicht der lokale Registrierungseintrag angezeigt werden soll.

Beispiel: remoteIC.exe getReg HKLM Software\testKey timeout


remoteIC.exe delReg rootKey key [valueName] [computer]

Entfernt einen Registrierungseintrag oder -schlⁿssel.

Parameter Beschreibung
rootKey HKLM: HKEY_LOCAL_MACHINE
HKCU: HKEY_CURRENT_USER
HKCR: HKEY_CLASSES_ROOT
HKU: HKEY_USERS
HKCC: HKEY_CURRENT_CONFIG
key Kompletter Registrierungsschlⁿssel unter dem ausgewΣhlten rootKey
valueName Wert welcher empfernt werden soll. Wenn kein Wert angegeben wird, wird der Schlⁿssel gel÷scht.
computer Computername wenn der Registrierungseintrag nicht auf dem lokalen Computer gel÷scht werden soll.

Beispiel: remoteIC.exe delReg HKLM Software\testKey timeout


remoteIC.exe getRegTime rootKey key

Gibt Erstellungsdatum und -zeit eines Registrierungsschlⁿssels aus.

Parameter Beschreibung
rootKey HKLM: HKEY_LOCAL_MACHINE
HKCU: HKEY_CURRENT_USER
HKCR: HKEY_CLASSES_ROOT
HKU: HKEY_USERS
HKCC: HKEY_CURRENT_CONFIG
key Kompletter Registrierungsschlⁿssel unter dem ausgewΣhlten rootKey

Beispiel: remoteIC.exe getRegTime HKLM Software\testKey


remoteIC.exe waitForReg rootKey key valueName [\\computer] [/t:timeout]

Wartet bis ein bestimmter Registrierungsschlⁿssel oder -wert erstellt worden ist.

Parameter Beschreibung
rootKey HKLM: HKEY_LOCAL_MACHINE
HKCU: HKEY_CURRENT_USER
HKCR: HKEY_CLASSES_ROOT
HKU: HKEY_USERS
HKCC: HKEY_CURRENT_CONFIG
key Kompletter Registrierungsschlⁿssel unter dem ausgewΣhlten rootKey
valueName Der Wert unterhalb des Schlⁿssels welcher abgefragt werden soll
\\computer Computername wenn der Registrierungseintrag nicht auf dem lokalen Computer abgefragt werden soll.
Bei Remotecomputern k÷nnen nur Schlⁿssel aus HKLM und HKU abgefragt werden.
/t:[timeout] Maximale Wartezeit in Sekunden

Beispiele:
remoteIC.exe waitForReg HKLM Software\testKey entry /t:30
remoteIC.exe waitForReg HKLM "Software\testKey key" \\remotepc /t:30


remoteIC.exe waitForDelReg rootKey key valueName [\\computer] [/t:timeout]

Wartet bis ein bestimmter Registrierungsschlⁿssel oder -wert gel÷scht worden ist.

Parameter Beschreibung
rootKey HKLM: HKEY_LOCAL_MACHINE
HKCU: HKEY_CURRENT_USER
HKCR: HKEY_CLASSES_ROOT
HKU: HKEY_USERS
HKCC: HKEY_CURRENT_CONFIG
key Kompletter Registrierungsschlⁿssel unter dem ausgewΣhlten rootKey
valueName Der Wert unterhalb des Schlⁿssels welcher abgefragt werden soll
\\computer Computername wenn der Registrierungseintrag nicht auf dem lokalen Computer abgefragt werden soll.
Bei Remotecomputern k÷nnen nur Schlⁿssel aus HKLM und HKU abgefragt werden.
/t:[timeout] Maximale Wartezeit in Sekunden

Beispiele:
remoteIC.exe waitForDelReg HKLM Software\testKey entry /t:30
remoteIC.exe waitForDelReg HKLM "Software\testKey key" \\remotepc /t:30


remoteIC.exe waitForFile path [timeout]

Wartet bis eine Datei vorhanden ist.

Parameter Beschreibung
path Kompletter Pfad zur Datei
[timeout] Maximale Wartezeit in Sekunden

Beispiel: remoteIC.exe waitForFile "C:\Program Files\test.txt" 5


remoteIC.exe waitForTextInFile path searchText [timeout]

Wartet bis ein betimmter Text in einer Datei gefunden worden ist.

Parameter Beschreibung
path Kompletter Pfad zur Datei
searchText Text nach welchem gesucht wird
[timeout] Maximale Wartezeit in Sekunden

Beispiel: remoteIC.exe waitForTextInFile "C:\Program Files\test.txt" "ResultCode=0" 15


remoteIC.exe waitForTextInReg rootKey key valueName [\\computer] [/s:searchtext] [/t:timeout]

Wartet bis ein Registrierungsschlⁿssel einen bestimmten Wert hat.

Parameter Beschreibung
rootKey HKLM: HKEY_LOCAL_MACHINE
HKCU: HKEY_CURRENT_USER
HKCR: HKEY_CLASSES_ROOT
HKU: HKEY_USERS
HKCC: HKEY_CURRENT_CONFIG
key Kompletter Registrierungsschlⁿssel unter dem ausgewΣhlten rootKey
valueName Der Wert unterhalb des Schlⁿssels welcher abgefragt werden soll
\\computer Computername wenn der Registrierungseintrag nicht auf dem lokalen Computer abgefragt werden soll.
Bei Remotecomputern k÷nnen nur Schlⁿssel aus HKLM und HKU abgefragt werden.
/s:[searchtext] Text nach welchem gesucht wird.
/t:[timeout] Maximale Wartezeit in Sekunden

Beispiele:
remoteIC.exe waitForTextInReg HKLM Software\testKey entry "/s:my search text" /t:30
remoteIC.exe waitForTextInReg HKLM "Software\testKey key" \\remotepc /s:598 /t:10


remoteIC.exe sendClickMessage ["/windowTitle:"] ["/controlText:" | /controlID:] [/showOutput] [/exact]

Sendet ein Mausklick an ein bestimmtes Windowselement.

Parameter Beschreibung
/windowTitle: Text welcher innerhalb des Fenstertitels gesucht werden soll. Der Mausklick wird an dieses Fenster geschickt. Wird kein Wert eingegeben, wird der Mausklick an das dem Element (Knopf) ⁿbergeordnete Fenster geschickt.
/controlText: Text welcher auf dem Element (Knopf) steht welcher den Mausklick erhalten soll.
/controlID: ID vom Element (Knopf) welcher den Mausklick erhalten soll.
/showOutput Zeigt den Rⁿckgabewert (debug).
/exact Der Text muss genau ⁿbereinstimmen.

Beispiele:
remoteIC.exe sendClickMessage "/windowTitle:Setup" "/controlText:&Next"
remoteIC.exe sendClickMessage "/windowTitle:Setup" /controlID:3680


remoteIC.exe sendTextMessage text ["/windowTitle:"] ["/controlText:" | /controlID:] [/showOutput] [/exact]

Fⁿllt einen bestimmten Text in ein Windowselement ein.

Parameter Beschreibung
text Text welcher eingefⁿllt werden soll.
/windowTitle: Text welcher innerhalb des Fenstertitels gesucht werden soll. Der Text wird an dieses Fenster geschickt. Wird kein Wert eingegeben, wird der Text an das dem Element (Eingabefeld) ⁿbergeordnete Fenster geschickt.
/controlText: Text welcher bereits im Element erfasst ist.
/controlID: ID vom Element (Eingabefeld) welches den Text erhalten soll.
/showOutput Zeigt den Rⁿckgabewert (debug).
/exact Der Text muss genau ⁿbereinstimmen.

Beispiel: remoteIC.exe sendTextMessage "c:\program files\mypath" "/windowTitle:Setup" /controlID:3680


remoteIC.exe sendMessage handle messageID wParamLow wParamHigh lParamLow lParamHigh ["/windowTitle:"] ["/controlText:" | /controlID:] [/showOutput] [/exact]

Sendet eine Windowsmessage an ein Element oder Fenster

Parameter Beschreibung
handle {windowsHandle} | {controlHandle}
messageID WM_COMMAND | WM_CHAR | WM_KEYDOWN | {Dezimalwert}
wParamLow {windowsHandle} | {controlHandle} | {controlID} | {integer Wert}
wParamHigh {windowsHandle} | {controlHandle} | {controlID} | {integer Wert}
lParamLow {windowsHandle} | {controlHandle} | {controlID} | {integer Wert}
lParamHigh {windowsHandle} | {controlHandle} | {controlID} | {integer Wert}
/windowTitle: Text welcher innerhalb des Fenstertitels gesucht werden soll. Die Message wird an dieses Fenster geschickt. Wird kein Wert eingegeben, wird die Message an das dem Element oder Fenster ⁿbergeordnete Fenster geschickt.
/controlText: Text welcher auf dem Element steht welcher die Message erhalten soll.
/controlID: ID vom Element welches die Message erhalten soll.
/showOutput Zeigt den Rⁿckgabewert (debug).
/exact Der Text muss genau ⁿbereinstimmen.

Beispiele:
remoteIC.exe sendMessage {windowsHandle} WM_COMMAND {controlID} 1 0 {controlHandle} "/windowTitle:Setup" /controlID:3680
remoteIC.exe sendMessage {windowsHandle} WM_COMMAND {controlID} 1 0 {controlHandle} "/windowTitle:Setup" "/controlText:Finish"


remoteIC.exe listWindow ["/searchText:"] ["/searchHandle:"] [/searchID:] [/showChildWindows]

Listet alle Fenster mit Ihren Untergeordneten Fenster auf.

Parameter Beschreibung
/searchText: Text nach welchem innerhalt des Fenstertitels oder der Elementbezeichnung gesucht wird.
/searchHandle: Fenster-Handle nach welchem gesucht werden soll.
/searchID: ControlID nach welcher gesucht werden soll
/showChildWindows Zeigt alle untergeordneten Fenster ebenfalls an.

Beispiel: remoteIC.exe listWindow "/searchText:Setup" /showChlidWindows


remoteIC.exe waitForWindow ["/windowTitle:"] ["/controlText:" | /controlID:] [/timeout:] [/exact]

Wartet bis ein bestimmtes Fenster ge÷ffnet wird.

Parameter Beschreibung
/windowTitle: Text welcher innerhalb des Fenstertitels gesucht werden soll.
/controlText: Text von einem Element auf welches gewartet werden soll.
/controlID: ID vom Element auf welches gewartet werden soll.
/timeout Maximale Wartezeit
/exact Der Text muss genau ⁿbereinstimmen.

Beispiel: remoteIC.exe waitForWindow "/windowTitle:Setup" "/controlText:&Next"


remoteIC.exe sendOptionMessage ["/radioText:"] ["/controlText:" | /controlID:] [/showOutput] [/exact]

Sendet einen Mausklick an ein Radio- oder Optionbox-Element.

Parameter Beschreibung
/radioText: Text der Gruppe von Radio-Kn÷pfen.
/controlText: Text von einem Element welches den Mausklick erhalten soll.
/controlID: ID vom Element welches den Mausklick erhalten soll.
/showOutput Zeigt den Rⁿckgabewert (debug).
/exact Der Text muss genau ⁿbereinstimmen.

Beispiele:
remoteIC.exe sendOptionMessage "/radioText:MsiRadioButtonGroup" "/controlText:&Custom"
remoteIC.exe sendOptionMessage "/radioText:MsiRadioButtonGroup" /controlID:4063


remoteIC.exe sendCheckMessage ["/windowTitle:"] ["/controlText:" | /controlID:] [/showOutput] [/exact]

Sendet einen Mausklick an ein Checkbox-Element.

Parameter Beschreibung
/windowTitle: Text des ⁿbergeordneten Fensters
/controlText: Text von einem Element welches den Mausklick erhalten soll.
/controlID: ID vom Element welches den Mausklick erhalten soll.
/showOutput Zeigt den Rⁿckgabewert (debug).
/exact Der Text muss genau ⁿbereinstimmen.

Beispiele:
remoteIC.exe sendCheckMessage "/windowTitle:Installation" "/controlText:Add icon to desktop"