[comment]: # translation:outdated

[comment]: # ({4f2ac53b-4f2ac53b})
# script.update

[comment]: # ({/4f2ac53b-4f2ac53b})

[comment]: # ({3c9f3e07-3bbc6786})
### Beschreibung

`object script.update(object/array scripts)`

Diese Methode ermöglicht die Aktualisierung vorhandener Skripte.

::: noteclassic
Diese Methode ist nur für den Benutzertyp *Super admin* verfügbar.
Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Siehe
[Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles)
für weitere Informationen.
:::

[comment]: # ({/3c9f3e07-3bbc6786})

[comment]: # ({8f315bab-8f315bab})
### Parameter

`(object/array)` zu aktualisierende [Skript-Eigenschaften](object#script).

Die Eigenschaft `scriptid` muss für jedes Skript definiert sein, alle anderen
Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle
anderen bleiben unverändert. Eine Ausnahme ist die Änderung der Eigenschaft `type`
von 5 (webhook) zu einem anderen Wert: Die Eigenschaft `parameters` wird geleert.

[comment]: # ({/8f315bab-8f315bab})

[comment]: # ({5062432a-5062432a})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten Skripte
unter der Eigenschaft `scriptids` enthält.

[comment]: # ({/5062432a-5062432a})

[comment]: # ({b41637d2-b41637d2})
### Beispiele

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({96417b97-4f3506ff})
#### Skriptbefehl ändern

Ändern Sie den Befehl des Skripts in „/bin/ping -c 10 {HOST.CONN}
2>&1“.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "script.update",
    "params": {
        "scriptid": "1",
        "command": "/bin/ping -c 10 {HOST.CONN} 2>&1"
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "scriptids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/96417b97-4f3506ff})

[comment]: # ({7495fc5b-eb14467c})
#### Skriptbefehl ändern und manuelle Eingabe hinzufügen

Ändern Sie den Befehl des Skripts in "/bin/ping -c {MANUALINPUT}
{HOST.CONN} 2>&1".

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "script.update",
    "params": {
      "scriptid": "1",
      "command": "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1",
      "manualinput": "1",
      "manualinput_prompt": "Geben Sie die Anzahl der ICMP-Pakete an, die mit dem ping-Befehl gesendet werden sollen",
      "manualinput_validator": "^(?:[1-9]|10)$",
      "manualinput_validator_type": "0",
      "manualinput_default_value": "10"
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "scriptids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/7495fc5b-eb14467c})

[comment]: # ({cded8a11-cded8a11})
### Quelle

CScript::update() in *ui/include/classes/api/services/CScript.php*.

[comment]: # ({/cded8a11-cded8a11})