# System Informationen

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/

Über die Systemfunktionen können Informationen über das System und die vorhandene Hardware ausgelesen werden. Die gesammelten Informationen können zur Visualisierung oder anderweitig in Skripten verwendet werden.

## Sys_GetBattery

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-getbattery/

`array Sys_GetBattery()`

zeigt Informationen zur Batterie an

**Rückgabewert** (array): Array mit Informationen zur Batterie

Gibt Informationen über das Vorhandensein einer Batterie, ob sie in Gebrauch ist und wieviel Prozent der Batterie noch vorhanden sind. Die Angaben der Restlaufzeit und maximalen Batterielaufzeit werden in Sekunden angegeben.

**Beispiel**

```php
print_r(Sys_GetBattery());
/*
// Beispielausgabe auf einem Desktop PC ohne Batterie
// HasBattery ist verfügbar mit IP-Symcon 7.0+
Array
(
[HasBattery] =>
[OnBattery] =>
[IsCharging] =>
[BatteryLevel] => -1
[BatteryRemainingTime] => -1
[BatteryMaxTime] => -1
)
*/
```

## Sys_GetCPUInfo

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-getcpuinfo/

`array Sys_GetCPUInfo()`

zeigt die CPU Auslastung an

**Rückgabewert** (array): Array mit Informationen zur CPU-Auslastung

__Ab Version 4.0__
Liefert für jede CPU die aktuelle Last (CPU_*) und die momentane Durchschnittlast für alle CPU Kerne (CPU_AVG).

__Bis Version 3.4__
Liefert für jede CPU die aktuelle Last (CPU_*) und die Durchschnittlast der letzten 60 Sekunden für alle CPU Kerne (CPU_AVG). Die durchschnittliche Last wird berechnet, indem jeder Sekunde ein Messwert der aktuellen Last genommen und abgespeichert wird. Die durchschnittliche Last wird berechnet, indem die letzten 60 Messwerte addiert und durch 60 geteilt werden.

**Beispiel**

```php
print_r(Sys_GetCPUInfo());

/*
Array
(
    [CPU_0] => 3
    [CPU_AVG] => 3
)
*/
```

## Sys_GetHardDiskInfo

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-getharddiskinfo/

`array Sys_GetHardDiskInfo()`

zeigt den Festplattenspeicherplatz/-verbrauch an

**Rückgabewert** (array): Array mit Informationen zu allen Festplatten

Liefert Informationen zu den vorhandenen Festplatten im System inklusive der Größe und dem bereits verbrauchten Speicher.

**Beispiel**

```php
//Ab Version 4.0
print_r(Sys_GetHarddiskInfo());
/* Beispielausgabe:
Array
(
    [0] => Array
    (
        [LETTER] => c:\
        [LABEL] =>
        [TOTAL] => 53684989952
        [FREE] => 23275171840
    )

    [NUMDRIVES] => 1
)
*/

// Bis Version 3.4
print_r(Sys_GetHarddiskInfo());
/* Beispielausgabe:
Array
(
    [HDD0] => Array
    (
        [LETTER] => c:\
        [LABEL] =>
        [TOTAL] => 53684989952
        [FREE] => 23275171840
    )

    [NUMDRIVES] => 1
)
*/
```

## Sys_GetMemoryInfo

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-getmemoryinfo/

`array Sys_GetMemoryInfo()`

zeigt den Speicherverbrauch an

**Rückgabewert** (array): Array mit Informationen zum Gesamtspeicherverbrauch und virtuellen Speicherverbrauch

Gibt Informationen zum Speicherverbrauch des Betriebssystems.

**Beispiel**

```php
print_r(Sys_GetMemoryInfo());

/*
Array
(
    [TOTALPHYSICAL] => 1072467968
    [AVAILPHYSICAL] => 526647296
    [TOTALPAGEFILE] => 2420019200
    [AVAILPAGEFILE] => 1386422272
    [TOTALVIRTUAL] => 2147352576
    [AVAILVIRTUAL] => 1906978816
)
*/
```

## Sys_GetNetworkInfo

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-getnetworkinfo/

`array Sys_GetNetworkInfo()`

zeigt Informationen zu den Netzwerkadaptern

**Rückgabewert** (array): Array mit Informationen zu allen Netzwerkadaptern

Liefert Informationen über alle Netzwerkadapter

**Beispiel**

```php
print_r(Sys_GetNetworkInfo());
/*
// Beispielausgabe

Array
(
[0] =>	Array
		(
		[InterfaceIndex] => 10
		[IP] => 192.168.1.2
		[MAC] => 00:A0:03:AD:14:BD
		[Description] => Siemens I BT USB Remote NDIS Network Device
		[Speed] => 9728000
		[InTotal] => 40236
		[OutTotal] => 247248
		)

[1] =>	Array
		(
		[InterfaceIndex] => 13
		[IP] => 172.12.1.200
		[MAC] => 00:A0:03:AD:14:BD
		[Description] => Qualcomm Atheros AR8151 PCI-E Gigabit Ethernet Controller (NDIS 6.30)
		[Speed] => 1000000000
		[InTotal] => 169987950
		[OutTotal] => 86029648
		)
)
*/
```

## Sys_GetProcessInfo

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-getprocessinfo/

`array Sys_GetProcessInfo()`

listet alle Prozesse auf

**Rückgabewert** (array): Array mit Informationen, wie z.B. Speicherverbrauch und Anzahl der Threads

Gibt Informationen zum Prozess von IP-Symcon.

**Beispiel**

```php
print_r(Sys_GetProcessInfo());
/*
Array
(
    [IPS_HANDLECOUNT] => 635
    [IPS_NUMTHREADS] => 53
    [IPS_VIRTUALSIZE] => 240373760
    [IPS_WORKINGSETSIZE] => 32706560
    [IPS_PAGEFILE] => 52719616
    [PROCESSCOUNT] => 53
)
*/
```

## Sys_GetSpooler

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-getspooler/

`array Sys_GetSpooler()`

zeigt Informationen zu den Druckerwarteschlangen an

**Rückgabewert** (array): Array mit Informationen zu allen Druckerwarteschlagen und den im Druck befindlichen Dokumenten

Gibt Informationen über alle Druckerwarteschlangen aus

> **Achtung:** Diese Funktion funktioniert nur unter Windows

**Beispiel**

```php
print_r(Sys_GetSpooler());
```

## Sys_GetURLContent

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-geturlcontent/

`string Sys_GetURLContent(string $URL)`

liest den Inhalt einer URL als String aus

**Parameter**

- `$URL` (string): Vollständige URL

**Rückgabewert** (string): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis den Inhalt der Webseite (auch Binärcode), andernfalls __FALSE__.

Vollständige URL

**Beispiel**

```php
echo Sys_GetURLContent("http://www.google.de");
```

## Sys_GetURLContentEx

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-geturlcontentex/

`string Sys_GetURLContentEx(string $URL, array $Parameter)`

liest den Inhalt einer URL als String aus und bietet die Möglichkeit einen Proxy zu spezifizieren

**Parameter**

- `$URL` (string): Vollständige URL
- `$Parameter` (array)

  Array mit Index => Value Paaren

  | Index      | Typ     | Beschreibung                                                                                                                                                        |
  | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Timeout    | Integer | __Default = 10000__. Timeout in Millisekunden                                                                                                                       |
  | AuthUser   | String  | __Default = ""__. Benutzername für Basis-Authentifizierung                                                                                                          |
  | AuthPass   | String  | __Default = ""__. Passwort für Basis-Authentifizierung                                                                                                              |
  | VerifyPeer | Boolean | __Default = true__. Verifiziere, dass das SSL Zertifikat des Hosts korrekt ist (nur sichtbar falls Benutze SSL aktiv ist)                                           |
  | VerifyHost | Boolean | __Default = true__. Verifiziere, dass die Host URL aus dem SSL Zertifikat mit dem Host aus der Eigenschaft übereinstimmt (nur sichtbar falls Benutze SSL aktiv ist) |

**Rückgabewert** (string): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis den Inhalt der Webseite (auch Binärcode), andernfalls __FALSE__.

Array mit Index => Value Paaren

| Index      | Typ     | Beschreibung                                                                                                                                                        |
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Timeout    | Integer | __Default = 10000__. Timeout in Millisekunden                                                                                                                       |
| AuthUser   | String  | __Default = ""__. Benutzername für Basis-Authentifizierung                                                                                                          |
| AuthPass   | String  | __Default = ""__. Passwort für Basis-Authentifizierung                                                                                                              |
| VerifyPeer | Boolean | __Default = true__. Verifiziere, dass das SSL Zertifikat des Hosts korrekt ist (nur sichtbar falls Benutze SSL aktiv ist)                                           |
| VerifyHost | Boolean | __Default = true__. Verifiziere, dass die Host URL aus dem SSL Zertifikat mit dem Host aus der Eigenschaft übereinstimmt (nur sichtbar falls Benutze SSL aktiv ist) |

**Beispiel**

```php
// Rückgabe von http://www.google.de mit Basis-Authentifizierung "test", Passwort "test123" und einen Timeout von 20 Sekunden
echo Sys_GetURLContentEx("http://www.google.de", Array("Timeout"=> 20000, "AuthUser"=> "test", "AuthPass"=> "test123"));
```

## Sys_Ping

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/kern-instanzen/system-informationen/sys-ping/

`bool Sys_Ping(string $Host, int $Timeout)`

sendet einen Ping an ein Netzwerkgerät

**Parameter**

- `$Host` (string): Rechnername oder IP-Adresse
- `$Timeout` (int): Zeit in Millisekunden

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Zeit in Millisekunden

**Beispiel**

```php
Sys_Ping("meinrechner", 1000); //Max. 1 Sekunde warten
```