PowerShellOnTargetMachines@1 - مهمة PowerShell على الأجهزة الهدف v1

استخدم هذه المهمة لتنفيذ برامج PowerShell النصية على الجهاز (الأجهزة) البعيدة.

بناء الجملة

# PowerShell on Target Machines v1
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    ScriptPath: # string. Required. PowerShell Script. 
    #ScriptArguments: # string. Script Arguments. 
    #InitializationScriptPath: # string. Initialization Script. 
    #SessionVariables: # string. Session Variables. 
  # Advanced Options
    #RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

الإدخالات

EnvironmentName - الات
string. مطلوب

يحدد قائمة مفصولة بفواصل من عناوين IP للجهاز أو FQDNs، جنبا إلى جنب مع المنافذ. يستند المنفذ الافتراضي إلى البروتوكول المحدد.
على سبيل المثال:dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
يمكنك أيضا توفير متغير الإخراج للمهام الأخرى، على سبيل المثال $(variableName). إذا كنت تستخدم HTTPS، يجب أن يتطابق اسم الجهاز أو IP مع CN في الشهادة.

AdminUserName - تسجيل الدخول مسؤول
string.

تحديد تسجيل دخول المسؤول للأجهزة المستهدفة.

AdminPassword - كلمه المرور
string.

تحديد كلمة مرور المسؤول للأجهزة المستهدفة. المتغيرات المحددة في تعريفات الإنشاء/الإصدار كما $(passwordVariable) هي مقبولة. يمكنك وضع علامة على نوع المتغير على أنه secret لتأمينه.

Protocol - البروتوكول
string. القيم المسموح بها: Http، . Https

يحدد البروتوكول الذي يجب استخدامه لاتصال WinRM مع الجهاز (الأجهزة). القيمة الافتراضية هي HTTPS.

TestCertificate - اختبار الشهادة
boolean. ‏‏اختياري. استخدم عندما Protocol = Https. القيمة الافتراضية: true.

يتخطى التحقق من صحة شهادة الجهاز من قبل مرجع مصدق موثوق به. المعلمة مطلوبة لبروتوكول WinRM HTTPS.

ScriptPath - برنامج PowerShell النصي
string. مطلوب

يحدد موقع البرنامج النصي PowerShell على الأجهزة المستهدفة أو على مسار UNC، مثل C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - وسيطات البرنامج النصي
string.

يحدد وسيطات البرنامج النصي PowerShell. يمكن أن تكون معلمات ترتيبية أو مسماة، مثل -testParam الاختبار.

InitializationScriptPath - البرنامج النصي للتهيئة
string.

يحدد موقع البرنامج النصي للبيانات ل DSC على الأجهزة المستهدفة أو على مسار UNC، مثل C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - متغيرات الجلسة
string.

يحدد متغيرات الجلسة الشائعة لكلا البرنامجين النصيين. على سبيل المثال، $variable = value أو $var1 = "value, 123".

RunPowershellInParallel - تشغيل PowerShell بالتوازي
boolean. القيمة الافتراضية: true.

إذا تم تعيينه إلى true، يقوم بتشغيل البرامج النصية PowerShell بالتوازي على الأجهزة الهدف.

ResourceFilteringMethod - تحديد الأجهزة حسب
string. القيم المسموح بها: machineNames (أسماء الأجهزة)، tags. القيمة الافتراضية: machineNames.

‏‏اختياري. يحدد مجموعة فرعية من الأجهزة عن طريق توفير أسماء الأجهزة أو العلامات.

MachineNames - معايير التصفية
string.

هذا الإدخال صالح فقط لمجموعات الأجهزة أو متغيرات الإخراج. وهو غير مدعوم لقائمة مسطحة من الأجهزة حتى الآن.

يحدد قائمة بالأجهزة، مثل dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 أو العلامات، مثل Role:DB; OS:Win8.1. إذا تم تحديد علامات متعددة، فسيتم تشغيل المهمة في جميع الأجهزة ذات العلامات المحددة. يقوم الإعداد الافتراضي بتشغيل المهمة في جميع الأجهزة.

خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	بلا
القدرات	لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	1.104.0 أو أحدث
فئة المهمة	نشر