التوثيقتنفيذ الوكيل
الوظيفة | تنفيذ برنامج على النظام المستهدف (Windows فقط) |
|---|---|
تنبيه | رمز الخروج، وقت التشغيل |
تفاصيل تنفيذ الوكيل
معلمات تنفيذ الوكيل
المعلمة | الوصف |
|---|---|
مسار البرنامج | البرنامج القابل للتنفيذ بما في ذلك مساره المطلق. يجب السماح بهذا المسار أو هذا البرنامج القابل للتنفيذ المحدد في قسم تشغيل البرامج في تكوين WinAgent عن بُعد. |
حجة سطر الأوامر | حجج سطر الأوامر للبرنامج القابل للتنفيذ. |
المهلة | سيتم إنهاء البرنامج القابل للتنفيذ بعد انتهاء فترة المهلة، إذا كان لا يزال قيد التشغيل. إذا تم تعيينه، فإن مهلة الانتظار هذه تتجاوز مهلة الانتظار الافتراضية في تكوين WinAgent عن بُعد (مهلة انتظار العملية الافتراضية). |
تنفيذ مثيل واحد فقط | يُسمح بتشغيل نسخة واحدة فقط من الملف القابل للتنفيذ إذا تم تحديد هذا الخيار. إذا كان الملف القابل للتنفيذ موجودًا بالفعل في قائمة البرامج قيد التشغيل في النظام الهدف، فلن يتم تشغيله مرة أخرى. |
إخفاء النافذة أثناء التنفيذ | إذا تم تحديد مربع الاختيار هذا، فإن WinAgent يخفي نوافذ التطبيق الذي يتم تنفيذه. |
إخفاء وقت التشغيل | إذا تم تحديد مربع الاختيار هذا، فلن يتم حفظ وقت تشغيل كل فحص في قاعدة البيانات ولن تكون قيمته مرئية في قسم القيم. كما أن قيمته لن تكون متاحة للاستخدام في مواصفات حدود الإنذار. |
تسمح القائمة المنسدلة "العلامات" بإدخال متغيرات محددة مسبقًا في الحقول أعلاه، على سبيل المثال $NAME$ لاسم المهمة.
قيم تنفيذ الوكيل وحدود الإنذار
القيمة / حد الإنذار | الوصف |
|---|---|
رمز الخروج | رمز الخروج الذي يعيده الملف القابل للتنفيذ. عادةً ما يعني رمز الخروج 0 عدم وجود أخطاء أثناء التنفيذ، ولكن رمز الخروج يعتمد على الملف القابل للتنفيذ. |
وقت التشغيل | مدة تنفيذ البرنامج عن بُعد (بالثواني). لا تتوفر هذه القيمة وحدود الإنذار إلا إذا لم يتم تمكين المعلمة "منع وقت التشغيل". |
رمز الخطأ | رمز خطأ عام للمهمة (انظر قسم رموز أخطاء المهام) |
أمثلة على تنفيذ الوكيل
مثال 1 - إصدار أمر إعادة تشغيل عن بُعد
يستخدم هذا المثال الأمر النظامي shutdown.exe مع الوسيطة /r لإعادة تشغيل الجهاز عن بُعد.
يتطلب ذلك السماح بالأمر أو الدليل الأصلي في تكوين WinAgent عن بُعد في علامة التبويب تشغيل البرامج:
الإخراج 1
المثال 2 - التحقق من تشغيل الخدمة w32time باستخدام الأمر wmic على الجهاز البعيد
يؤدي هذا إلى تشغيل الأمر التالي والتحقق من تشغيل الخدمة w32time على الجهاز البعيد:
مسار البرنامج | C:\Windows\system32\cmd.exe |
|---|---|
حجة سطر الأوامر. | /C FOR /F %G IN ('wmic service w32time get state /value ^| findstr "State=Running"') Do exit /B 0 |
يجب أيضًا السماح بتنفيذ cmd.exe في تكوين WinAgent البعيد في علامة التبويب تشغيل البرامج (انظر أعلاه).
يتيح ذلك التحقق من حالة الخدمة على الأجهزة البعيدة التي تعمل بنظام Windows 2000 على سبيل المثال، والذي لا يدعم المكون الإضافي لمهمة خدمة الوكيل.
الإخراج 2
إذا كانت الخدمة قيد التشغيل، يكون رمز الخروج = 0، وإذا كانت متوقفة أو غير متاحة، يكون رمز الخروج = 1.
مثال 3 - اختبار اتصال خادم من مضيف Windows باستخدام PowerShell
ستقوم هذه المهمة باختبار اتصال الخادم server1 من نظام Windows وستُرجع رمز الخروج 0 في حالة النجاح أو 1 في حالة الفشل.
مسار البرنامج | %SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe |
|---|---|
حجة سطر الأوامر. | if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1} |
يجب أيضًا السماح بـ PowerShell.exe في تكوين WinAgent عن بُعد في علامة التبويب تشغيل البرامج (انظر أعلاه).