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