AzurePowerShell@3 - مهمة Azure PowerShell v3

استخدم هذه المهمة لتشغيل برنامج نصي PowerShell داخل بيئة Azure. تتم مصادقة سياق Azure مع اتصال خدمة Azure Resource Manager المتوفر.

بناء الجملة

# Azure PowerShell v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    #ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments. 
    #errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
    #FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
  # Azure PowerShell version options
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version. 
  # Advanced
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.

الإدخالات

azureConnectionType - نوع اتصال Azure
الاسم المستعار للإدخل: ConnectedServiceNameSelector. string. القيم المسموح بها: ConnectedServiceName (Azure Classic)، ConnectedServiceNameARM (Azure Resource Manager). القيمة الافتراضية: ConnectedServiceNameARM.

azureClassicSubscription - اشتراك Azure Classic
الاسم المستعار للإدخل: ConnectedServiceName. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceName.

اشتراك Azure Classic للتكوين قبل تشغيل PowerShell.

azureSubscription - اشتراك Azure
الاسم المستعار للإدخل: ConnectedServiceNameARM. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceNameARM.

اشتراك Azure Resource Manager للتكوين قبل تشغيل PowerShell.

ScriptType - نوع البرنامج النصي
string. القيم المسموح بها: FilePath (مسار ملف البرنامج النصي)، InlineScript (البرنامج النصي المضمن). القيمة الافتراضية: FilePath.

نوع البرنامج النصي: مسار الملف أو المضمن.

ScriptPath - مسار البرنامج النصي
string. ‏‏اختياري. استخدم عندما ScriptType = FilePath.

مسار البرنامج النصي. يجب أن يكون هذا مسارا مؤهلا بالكامل أو مسارا واحدا بالنسبة إلى دليل العمل الافتراضي.

Inline - البرنامج النصي المضمن
string. ‏‏اختياري. استخدم عندما ScriptType = InlineScript. القيمة الافتراضية: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

مواصفات البرنامج النصي لتنفيذه. الحد الأقصى لطول البرنامج النصي المضمن المدعوم هو 5000 حرف. استخدم برنامج نصي من ملف إذا كنت تريد استخدام برنامج نصي أطول.

ScriptArguments - وسيطات البرنامج النصي
string. ‏‏اختياري. استخدم عندما ScriptType = FilePath.

المعلمات الإضافية لتمريرها إلى PowerShell. يمكن أن تكون هذه إما معلمات ترتيبية أو مسماة.

errorActionPreference - ErrorActionPreference
string. القيم المسموح بها: stop، ، continuesilentlyContinue. القيمة الافتراضية: stop.

تحديد قيمة ErrorActionPreference المتغير لتنفيذ البرنامج النصي.

FailOnStandardError - فشل عند الخطأ القياسي
boolean. القيمة الافتراضية: false.

عندما يكون هذا صحيحا، ستفشل هذه المهمة إذا تمت كتابة أي أخطاء في مسار الخطأ أو إذا تمت كتابة أي بيانات إلى دفق الخطأ القياسي.

azurePowerShellVersion - إصدار Azure PowerShell
الاسم المستعار للإدخل: TargetAzurePs. string. القيم المسموح بها: LatestVersion (أحدث إصدار مثبت)، OtherVersion (تحديد إصدار آخر). القيمة الافتراضية: OtherVersion.

في حالة الوكلاء المستضافين، تكون إصدارات Azure PowerShell المدعومة هي 2.1.0و 4.2.13.8.05.1.1 و و6.7.0. لاختيار أحدث إصدار متوفر على العامل، حدد LatestVersion (أحدث إصدار مثبت).

بالنسبة للوكلاء الخاصين، يمكنك تحديد إصدار مفضل من Azure PowerShell باستخدام OtherVersion (تحديد إصدار آخر).

preferredAzurePowerShellVersion - إصدار Azure PowerShell المفضل
الاسم المستعار للإدخل: CustomTargetAzurePs. string. مطلوب عند TargetAzurePs = OtherVersion.

يجب أن يكون إصدار Azure PowerShell المفضل إصدارا دلاليا مناسبا على سبيل المثال. 1.2.3.. Regex like 2.\*,2.3.\* غير مدعوم. يدعم الوكلاء المستضافون حاليا إصدارات الوحدة النمطية ل Azure وإصدارات 2.1.02.1.03.8.05.1.16.7.04.2.13.8.04.2.15.1.1الوحدة النمطية AzureRM و.

validateScriptSignature - التحقق من صحة توقيع البرنامج النصي
boolean. ‏‏اختياري. استخدم عندما ScriptType = FilePath. القيمة الافتراضية: false.

إذا كان هذا صحيحا، فستتحقق المهمة أولا للتأكد من توقيع البرنامج النصي المحدد وصالح قبل تنفيذه.

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

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

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

لا شيء

الملاحظات

تمت إضافة دعم الفشل عند الخطأ القياسي و ErrorActionPreference.

المتطلبات

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