AzureCLI@2 - مهمة Azure CLI v2

تشغيل أوامر Azure CLI ضد اشتراك Azure في سكريبت PowerShell Core/shell عند التشغيل على وكيل لينكس. أو، تشغيل أوامر Azure CLI ضد اشتراك Azure في سكريبت PowerShell/PowerShell Core/batch عند التشغيل على وكيل Windows.

إعراب

# Azure CLI v2
# Run Azure CLI commands against an Azure subscription in a PowerShell Core/Shell script when running on Linux agent or PowerShell/PowerShell Core/Batch script when running on Windows agent.
- task: AzureCLI@2
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure Resource Manager connection. 
    scriptType: # 'ps' | 'pscore' | 'batch' | 'bash'. Required. Script Type. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: scriptArguments. Script Arguments. 
    #powerShellErrorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. Optional. Use when scriptType = ps || scriptType = pscore. ErrorActionPreference. Default: stop.
  # Advanced
    #addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
    #useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.
    #powerShellIgnoreLASTEXITCODE: false # boolean. Optional. Use when scriptType = ps || scriptType = pscore. Ignore $LASTEXITCODE. Default: false.
    #visibleAzLogin: true # boolean. az login output visibility. Default: true.

المدخلات

<اتصال c0 />Azure Resource Manager
الاسم المستعار للإدخل: connectedServiceNameARM. Person. مطلوب.

اختر اتصال خدمة Azure Resource Manager للنشر.

نوع البرنامج النصي scriptType -
Person. مطلوب. القيم المسموح بها: ps (PowerShell) pscore (PowerShell Core) batchbash (Shell).

نوع البرنامج النصي. حدد برنامج نصي bash أو pscore عند التشغيل على عامل Linux. أو اختر سكريبت batch، ps، أو pscore عند التشغيل على Windows الوكيل. يمكن لبرمجت pscore العمل على وكلاء متعدد المنصات (لينكس، ماك أو إس، أو Windows).

موقع البرنامج النصي scriptLocation -
Person. مطلوب. القيم المسموح بها: inlineScript (البرنامج النصي المضمن)، scriptPath (مسار البرنامج النصي). القيمة الافتراضية: scriptPath.

المسار إلى البرنامج النصي.

مسار البرنامج النصي scriptPath -
Person. مطلوب عند scriptLocation = scriptPath.

مسار مؤهل بالكامل للبرنامج النصي. استخدم .ps1، .bat، أو .cmd عند استخدام وكيل يعتمد على Windows. استخدم .ps1 أو .sh عند استخدام عامل يستند إلى Linux أو مسار نسبة إلى دليل العمل الافتراضي.

البرنامج النصي المضمن
Person. مطلوب عند scriptLocation = inlineScript.

يمكنك كتابة البرامج النصية الخاصة بك مضمنة هنا. عند استخدام وكيل Windows، استخدم PowerShell أو PowerShell Core أو البرمجة العشوائية. استخدم البرمجة النصية PowerShell Core أو shell عند استخدام عوامل تستند إلى Linux. بالنسبة لملفات الدفعات، استخدم البادئة call قبل كل أمر Azure. يمكنك أيضا تمرير متغيرات معرفة مسبقا ومخصصة إلى هذا البرنامج النصي باستخدام الوسيطات.

فيما يلي مثال على PowerShell/PowerShellCore/shell.

az --version 
az account show 

فيما يلي مثال على الدفعة.

call  az --version 
call az account show

وسيطات البرنامج النصي arguments -
الاسم المستعار للإدخل: scriptArguments. Person.

تم تمرير الوسيطات إلى البرنامج النصي.

powerShellErrorActionPreference - ErrorActionPreference
Person. اختياري. استخدم عند scriptType = ps || scriptType = pscore. القيم المسموح بها: stopcontinuesilentlyContinue. القيمة الافتراضية: stop.

إلحاق السطر $ErrorActionPreference = 'VALUE' في الجزء العلوي من البرنامج النصي PowerShell/PowerShell Core.

addSpnToEnvironment - تفاصيل كيان خدمة Access في البرنامج النصي
Person. القيمة الافتراضية: false.

يضيف معرف الخدمة، ومفتاح الخدمة، أو رمز اتحاد هوية عبء العمل، ومعرف المستأجر لنقطة نهاية Azure التي اخترتها إلى بيئة تنفيذ السكريبت. يمكنك استخدام المتغيرات servicePrincipalIdservicePrincipalKey أو idTokentenantId في البرنامج النصي الخاص بك.

يتم الالتزام بذلك فقط عندما يكون لدى نقطة نهاية Azure نظام مصادقة أصل الخدمة أو نظام مصادقة اتحاد هوية عبء العمل.

تعرض القائمة التالية بناء الجملة للوصول إلى متغيرات البيئة استنادا إلى نوع البرنامج النصي.

• بناء جملة البرنامج النصي PowerShell: $env:servicePrincipalId

• بناء جملة البرنامج النصي الدفعي: %servicePrincipalId%

• بناء جملة البرنامج النصي Shell: $servicePrincipalId

useGlobalConfig - استخدم تكوين Azure CLI العالمي
Person. القيمة الافتراضية: false.

إذا كان هذا المدخل خاطئا، ستستخدم هذه المهمة مجلد تكوين خاص بها Azure CLI. استخدم هذه المهمة لتشغيل Azure CLI المهام في إصدارات parallel.

دليل العمل workingDirectory -
الاسم المستعار للإدخل: cwd. Person.

دليل العمل الحالي حيث يتم تشغيل البرنامج النصي. إذا ترك فارغا، فهذا الإدخال هو جذر المستودع (البناء) أو البيانات الاصطناعية (الإصدار)، وهو $(System.DefaultWorkingDirectory).

فشل failOnStandardError - في الخطأ القياسي
Person. القيمة الافتراضية: false.

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

تجاهل powerShellIgnoreLASTEXITCODE - $LASTEXITCODE
Person. اختياري. استخدم عند scriptType = ps || scriptType = pscore. القيمة الافتراضية: false.

إذا كان هذا الإدخال خاطئا، يتم إلحاق if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE } السطر بنهاية البرنامج النصي. سيؤدي ذلك إلى نشر رمز الخروج الأخير من أمر خارجي كتعليلة برمجية للخروج من PowerShell. وإلا، فلن يتم إلحاق السطر بنهاية البرنامج النصي.

visibleAzLogin - رؤية إخراج تسجيل الدخول من az
Person. القيمة الافتراضية: true.

إذا تم تعيين هذا إلى true، فسيخرج الأمر az login إلى المهمة. سيؤدي تعيينه إلى false إلى منع إخراج تسجيل الدخول من az.

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

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

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

اي.

ملاحظات

ما الجديد في إصدار مهمة الإصدار 2.0

• دعم البرنامج النصي PowerShell وPowerShell Core.
• يعمل PowerShell Core مع وكلاء عبر المنصات (لينكس، macOS، أو Windows)، تأكد من أن الوكيل يحتوي على PowerShell الإصدار 6 أو أكثر.
• يعمل سكريبت PowerShell فقط مع وكيل Windows، تأكد من أن الوكيل يحتوي على PowerShell الإصدار 5 أو أقل.

المتطلبات الأساسية

• اشتراك في Microsoft Azure.
• Azure Resource Manager اتصال الخدمة إلى حسابك Azure.
• الوكلاء المستضافين في Microsoft لديهم Azure CLI مثبتة مسبقا. ومع ذلك، إذا كنت تستخدم وكلاء خاصين، install Azure CLI على الكمبيوتر الذي يشغل وكيل البناء والإصدار. إذا كان هناك وكيل يعمل بالفعل على الجهاز الذي تم تثبيت Azure CLI عليه، أعد تشغيل الوكيل لضمان تحديث جميع متغيرات المرحلة ذات الصلة.

امثله

المثال التالي يوضح إصدار Azure CLI ويحصل على تفاصيل الاشتراك.

- task: AzureCLI@2
  displayName: Azure CLI
  inputs:
    azureSubscription: <Name of the Azure Resource Manager service connection>
    scriptType: ps
    scriptLocation: inlineScript
    inlineScript: |
      az --version
      az account show

يوضح المثال التالي كيفية تمرير الوسيطات إلى البرنامج النصي الخاص بك.

• تمرير الوسيطات إلى البرامج النصية المضمنة:

  - task: AzureCLI@2
    inputs:
      azureSubscription: <Azure_Resource_Manager_Service_Connection>
      scriptType: 'ps'
      scriptLocation: 'inlineScript'
      arguments: '$(AZURE_STORAGE_ACCOUNT) $(AZURE_STORAGE_KEY)'
      inlineScript: './scripts/publish.ps1 $1 $2'
  

• تمرير الوسيطات مع مسار البرنامج النصي:

  - task: AzureCLI@2
    inputs:
      azureSubscription: <Azure_Resource_Manager_Service_Connection>
      scriptType: 'ps'
      scriptLocation: 'scriptPath'
      arguments: '$(AZURE_STORAGE_ACCOUNT) $(AZURE_STORAGE_KEY)'
      scriptPath: './scripts/publish.ps1'
  

المتطلبات

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

راجع أيضًا

• Azure نشر مجموعة الموارد
• Azure نشر الخدمة السحابية
• Azure نشر تطبيقات الويب