[comment]: # translation:outdated [comment]: # ({ff24327c-cb4f1ad1}) # 2 Agent Zabbix sur Microsoft Windows [comment]: # ({/ff24327c-cb4f1ad1}) [comment]: # ({c1e0c5f9-3383ef75}) #### Configuration de l'agent L'agent Zabbix s'exécute en tant que service Windows. Vous pouvez exécuter une seule instance de l'agent Zabbix ou plusieurs instances de l'agent sur un hôte Microsoft Windows. Une seule instance peut utiliser le fichier de configuration par défaut `C:\zabbix_agentd.conf` ou un fichier de configuration spécifié dans la ligne de commande. En cas d'instances multiples, chaque instance d'agent doit avoir son propre fichier de configuration (l'une des instances peut utiliser le fichier de configuration par défaut). Un exemple de fichier de configuration est disponible dans les archives source Zabbix : `conf/zabbix_agentd.win.conf`. Voir les options de [fichier de configuration](/fr/manual/appendix/config/zabbix_agentd_win) pour plus de détails sur la configuration de l’agent Windows Zabbix. [comment]: # ({/c1e0c5f9-3383ef75}) [comment]: # ({7feedef9-c8b9e236}) ##### Paramètre hostname Pour effectuer des [vérifications actives](/fr/manual/appendix/items/activepassive#verifications_actives) sur un hôte, vous devez définir le nom d'hôte de l'agent Zabbix. De plus, la valeur du nom d'hôte définie du côté de l'agent doit correspondre exactement au [nom d'hôte](/fr/manual/config/hosts/host) configuré pour l'hôte dans l'interface frontale. La valeur du nom d'hôte du côté de l'agent peut être définie par le paramètre **Hostname** ou **HostnameItem** dans le [fichier de configuration](/fr/manual/appendix/config/zabbix_agentd_win) de l'agent - ou les valeurs par défaut sont utilisées si aucun de ces paramètres n'est spécifié. La valeur par défaut du paramètre **HostnameItem** est la valeur renvoyée par la clé d'agent "system.hostname" et, pour la plate-forme Windows, renvoie le nom d'hôte NetBIOS. La valeur par défaut pour **Hostname** est la valeur renvoyée par le paramètre **HostnameItem**. Donc, en réalité, si ces deux paramètres ne sont pas spécifiés, le nom d'hôte réel sera le nom NetBIOS de l'hôte ; L'agent Zabbix utilisera le nom d'hôte NetBIOS pour extraire la liste des vérifications actives du serveur Zabbix et lui envoyer les résultats. ::: noteimportant La clé **system.hostname** retourne toujours le nom d'hôte NetBIOS qui est limité à 15 symboles et en majuscule uniquement - indépendamment de la longueur et des caractères minuscules/majuscules dans le nom d'hôte réel. ::: À partir de la version 1.8.6 de l’agent Zabbix pour Windows, la clé "system.hostname" prend en charge un paramètre facultatif - *type* du nom. La valeur par défaut de ce paramètre est "netbios" (pour la compatibilité ascendante) et l'autre valeur possible est "hôte". ::: noteimportant La clé **system.hostname\[host\]** retourne toujours le nom d'hôte Windows complet, réel (sensible à la casse). ::: Donc, pour simplifier la configuration du fichier zabbix\_agentd.conf et le rendre unifié, deux approches différentes peuvent être utilisées : 1. laissez les paramètres **Hostname** ou **HostnameItem** non défini et l'agent Zabbix utilisera le nom d'hôte NetBIOS pour le paramètre hostname ; 2. laissez le paramètre **Hostname** non défini et définissez **HostnameItem** comme ceci :\ **HostnameItem=system.hostname\[host\]**\ et l'agent Zabbix utilisera le nom d'hôte Windows complet, réel (sensible à la casse) comme paramètre hostname. Le nom d'hôte est également utilisé dans le nom de service Windows utilisé pour l'installation, le démarrage, l'arrêt et la désinstallation du service Windows. Par exemple, si le fichier de configuration de l'agent Zabbix spécifie `Hostname=Windows_db_server`, l'agent sera installé en tant que service Windows "`Zabbix Agent [Windows_db_server]`". Par conséquent, pour avoir un nom de service Windows différent pour chaque instance d'agent Zabbix, chaque instance doit utiliser un nom d'hôte différent. [comment]: # ({/7feedef9-c8b9e236}) [comment]: # ({16240869-1c178c2a}) #### Installation de l'agent en tant que service Windows Pour installer une seule instance de l'agent Zabbix avec le fichier de configuration par défaut `c:\zabbix_agentd.conf` : zabbix_agentd.exe --install ::: noteimportant Sur les systèmes 64-bit, une version 64-bit de l'agent Zabbix est nécessaire pour toutes les vérifications associées à l'exécution de processus 64 bits pour fonctionner correctement. ::: Si vous souhaitez utiliser un fichier de configuration autre que `c:\zabbix_agentd.conf`, vous devez utiliser la commande suivante pour l'installation du service : zabbix_agentd.exe --config --install Un chemin d'accès complet au fichier de configuration doit être spécifié. Plusieurs instances de l'agent Zabbix peuvent être installées en tant que services tels que : zabbix_agentd.exe --config --install --multiple-agents zabbix_agentd.exe --config --install --multiple-agents ... zabbix_agentd.exe --config --install --multiple-agents Les services installés doivent maintenant être visible dans le Panneau de configuration. [comment]: # ({/16240869-1c178c2a}) [comment]: # ({755101d9-635edc59}) #### Démarrage de l'agent Pour démarrer l'agent, vous pouvez utiliser le Panneau de Configuration ou le faire via une ligne de commande. Pour démarrer une seule instance de l'agent Zabbix avec le fichier de configuration par défaut : zabbix_agentd.exe --start Pour démarrer une seule instance de l'agent Zabbix avec un autre fichier de configuration : zabbix_agentd.exe --config --start Pour démarrer une instance de l'agent Zabbix lorsqu'il en existe plusieurs : zabbix_agentd.exe --config --start --multiple-agents [comment]: # ({/755101d9-635edc59}) [comment]: # ({464b7cf5-f3f0d3db}) #### Arrêt de l'agent Pour arrêter le service de l'agent, vous pouvez utiliser le Panneau de Configuration ou via une ligne de commande. Pour arrêter une seule instance de l'agent Zabbix démarré avec le fichier de configuration par défaut : zabbix_agentd.exe --stop Pour arrêter une seule instance de l'agent Zabbix démarré avec un autre fichier de configuration : zabbix_agentd.exe --config --stop Pour arrêter une instance de l'agent Zabbix lorsqu'il en existe plusieurs : zabbix_agentd.exe --config --stop --multiple-agents [comment]: # ({/464b7cf5-f3f0d3db}) [comment]: # ({77bed162-db2e6708}) #### Désinstallation de l'agent Zabbix en tant que service Pour désinstaller une seule instance de l'agent Zabbix utilisant le fichier de configuration par défaut : zabbix_agentd.exe --uninstall Pour désinstaller une seule instance de l'agent Zabbix utilisant un autre fichier de configuration : zabbix_agentd.exe --config --uninstall Pour désinstaller plusieurs instances de l'agent Zabbix des services Windows : zabbix_agentd.exe --config --uninstall --multiple-agents zabbix_agentd.exe --config --uninstall --multiple-agents ... zabbix_agentd.exe --config --uninstall --multiple-agents [comment]: # ({/77bed162-db2e6708})