تنفيذ الوكيل

الوظيفة

تنفيذ برنامج على النظام المستهدف (Windows فقط)

الإنذار

Exit code, Running time

تفاصيل Agent Execute

معاملات Agent Execute

المعامل

الوصف

Program path

البرنامج القابل للتنفيذ متضمناً مساره المطلق. يجب السماح بهذا المسار أو بالبرنامج القابل للتنفيذ المحدد في قسم Run Programs ضمن تهيئة WinAgent البعيد.

Command line arg.

وسائط سطر الأوامر للبرنامج القابل للتنفيذ.

Timeout

سيتم إنهاء البرنامج القابل للتنفيذ بعد انتهاء مهلة الانتظار، إذا كان لا يزال قيد التشغيل. في حال تعيين هذه المهلة، فإنها تتجاوز المهلة الافتراضية في تهيئة WinAgent البعيد (Default process timeout).

Execute one instance only

يُسمح بتشغيل نسخة واحدة فقط من البرنامج القابل للتنفيذ عند تحديد هذا الخيار. إذا كان البرنامج القابل للتنفيذ موجوداً بالفعل في قائمة البرامج قيد التشغيل على النظام المستهدف، فلن يتم تشغيله مرة أخرى.

Hide window during execution

عند تحديد مربع الاختيار هذا، يقوم WinAgent بإخفاء نوافذ التطبيق المنفَّذ.

Suppress running time

عند تحديد مربع الاختيار هذا، لا يتم حفظ وقت التشغيل لكل فحص في قاعدة البيانات ولا تعد قيمته مرئية في قسم القيم. كما لا تعد قيمته متاحة للاستخدام في تحديد حدود الإنذار.

تتيح القائمة المنسدلة Tags إدخال متغيرات محددة مسبقاً في الحقول أعلاه، مثل $NAME$ لاسم المهمة.

قيم وحدود إنذار Agent Execute

القيمة / حد الإنذار

الوصف

Exit code

رمز الخروج الذي يُرجعه البرنامج القابل للتنفيذ. عادةً ما يعني رمز الخروج 0 عدم وجود أخطاء أثناء التنفيذ، ومع ذلك، يعتمد رمز الخروج على البرنامج القابل للتنفيذ نفسه.

Running time

مدة تنفيذ البرنامج البعيد (بالثواني). لا تتوفر هذه القيمة وحد الإنذار إلا إذا لم يكن المعامل Suppress running time ممكَّناً.

Error code

رمز خطأ عام للمهمة (انظر قسم رموز أخطاء المهام)

أمثلة على Agent Execute

مثال 1 - إصدار أمر إعادة تشغيل عن بُعد

يستخدم هذا المثال أمر النظام shutdown.exe مع الوسيط /r لإصدار أمر إعادة تشغيل للجهاز البعيد.

يتطلب ذلك السماح بالأمر أو بدليله الأب في تهيئة WinAgent البعيد ضمن تبويب Run programs:

المخرجات 1

مثال 2 - التحقق مما إذا كانت الخدمة w32time قيد التشغيل باستخدام الأمر wmic على الجهاز البعيد

يقوم هذا بتنفيذ الأمر التالي والتحقق مما إذا كانت الخدمة w32time قيد التشغيل على الجهاز البعيد:

Program path

C:\Windows\system32\cmd.exe

Command line arg.

/C FOR /F %G IN ('wmic service w32time get state /value ^| findstr "State=Running"') Do exit /B 0

يجب أيضاً السماح بالملف التنفيذي cmd.exe في تهيئة WinAgent البعيد ضمن تبويب Run programs (انظر أعلاه).

يتيح ذلك التحقق من حالة خدمة على الأجهزة البعيدة التي تعمل بنظام مثل Windows 2000، غير المدعوم في المكوّن الإضافي للمهمة Agent Service.

المخرجات 2

إذا كانت الخدمة قيد التشغيل، يكون رمز الخروج = 0، وإذا كانت متوقفة أو غير متوفرة يكون رمز الخروج = 1.

مثال 3 - إجراء اختبار Ping لخادم من مضيف Windows باستخدام PowerShell

ستقوم هذه المهمة بإجراء اختبار ping للخادم server1 من نظام Windows وإرجاع رمز الخروج 0 في حالة النجاح أو 1 في حالة الفشل.


Program path

%SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe

Command line arg.

if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1}

يجب أيضاً السماح بالملف PowerShell.exe  في تهيئة WinAgent البعيد ضمن تبويب Run programs (انظر أعلاه).