[comment]: # ({3a2a8d58-3a2a8d58})
# script.execute

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

[comment]: # ({ffbe5671-db848067})
### Description

`object script.execute(object parameters)`

Cette méthode permet d'exécuter un script sur un hôte.

[comment]: # ({/ffbe5671-db848067})

[comment]: # ({d5523c4f-cb68cbe8})
### Paramètres

`(object)` Paramètres contenant l'ID du script à exécuter et l'ID de
l'hôte.

|Paramètre|Type|Description|
|----------|----|-----------|
|**hostid**<br>(obligatoire)|string|ID de l'hôte sur lequel exécuter le script.|
|**scriptid**<br>(obligatoire)|string|ID du script à exécuter.|

[comment]: # ({/d5523c4f-cb68cbe8})

[comment]: # ({b7882518-125b6cea})
### Valeurs retournées

`(object)` Renvoie le résultat de l'exécution du script.

|Propriété|Type|Description|
|-----------|----|-----------|
|response|string|Indique si le script a été exécuté avec succès.<br><br>Valeurs possibles : `success` ou `failed`.|
|value|string|Sortie du script.|

[comment]: # ({/b7882518-125b6cea})

[comment]: # ({88e43968-b41637d2})
### Exemples

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

[comment]: # ({5667b06c-2eefb5f8})
#### Exécution d'un script

Exécuter un script "ping" sur un hôte.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "script.execute",
    "params": {
        "scriptid": "1",
        "hostid": "30079"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "value": "PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.\n64 bytes from 127.0.0.1: icmp_req=1 ttl=64 time=0.074 ms\n64 bytes from 127.0.0.1: icmp_req=2 ttl=64 time=0.030 ms\n64 bytes from 127.0.0.1: icmp_req=3 ttl=64 time=0.030 ms\n\n--- 127.0.0.1 ping statistics ---\n3 packets transmitted, 3 received, 0% packet loss, time 1998ms\nrtt min/avg/max/mdev = 0.030/0.044/0.074/0.022 ms\n"
    },
    "id": 1
}
```

[comment]: # ({/5667b06c-2eefb5f8})

[comment]: # ({e85de0c2-eca1562c})
### Source

CScript::execute() dans
*frontends/php/include/classes/api/services/CScript.php*.

[comment]: # ({/e85de0c2-eca1562c})