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

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

بناء الجملة

# PowerShell on Target Machines v2
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@2
  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.

يحدد تسجيل دخول المسؤول للأجهزة الهدف.
على سبيل المثال Domain\Admin User، Admin User@Domain، .\Admin User.

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. إذا تم تحديد علامات متعددة، فسيتم تشغيل المهمة في جميع الأجهزة ذات العلامات المحددة. يقوم الافتراضي بتشغيل المهمة في جميع الأجهزة.

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

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

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

لا شيء

الملاحظات

ما الجديد في الإصدار 2.0:

• تمت إزالة دعم أجهزة DTL القديمة.

المتطلبات

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