مشاركة عبر

AzureCLI@1 - مهمة Azure CLI v1

  • مقالة

قم بتشغيل أوامر Azure CLI مقابل اشتراك Azure في برنامج نصي shell عند التشغيل على عامل Linux أو البرنامج النصي الدفعي عند التشغيل على عامل Windows.

قم بتشغيل برنامج نصي shell أو batch باستخدام أوامر Azure CLI مقابل اشتراك Azure.

بناء الجملة

# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    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: args. Arguments. 
  # 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.

# Azure CLI v1
# Run a Shell or Batch script with Azure CLI commands against an azure subscription.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    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: args. Arguments. 
  # Advanced
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

الإدخالات

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

تحديد اشتراك Azure Resource Manager للتوزيع.


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

تحديد موقع البرنامج النصي.


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

مسار مؤهل بالكامل للبرنامج النصي أو مسار يتعلق بدليل العمل الافتراضي.


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

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

انظر الأمثلة التالية. الأول هو مثال shell والثاني هو مثال دفعي:

azure --version || azure account show 

call  azure --version || call azure account show

arguments - الحجج
الاسم المستعار للإدخل: args. string.

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


addSpnToEnvironment - الوصول إلى تفاصيل كيان الخدمة في البرنامج النصي
boolean. القيمة الافتراضية: false.

يضيف معرف كيان الخدمة ومفتاح نقطة نهاية Azure التي اخترتها إلى بيئة تنفيذ البرنامج النصي. يمكنك استخدام $servicePrincipalId المتغيرين و $servicePrincipalKey في البرنامج النصي الخاص بك.

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


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

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


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

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


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

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


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

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

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

لا شيء

الملاحظات

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

  • يدعم Azure CLI 2.0 الجديد الذي يستند إلى Python
  • يعمل مع وكلاء عبر الأنظمة الأساسية (Linux أو macOS أو Windows)
  • للعمل مع Azure CLI 1.0 (المستند إلى node.js)، قم بالتبديل إلى إصدار المهمة 0.0
  • القيود: - لا يوجد دعم لاشتراكات Azure Classic. يدعم Azure CLI 2.0 اشتراكات Azure Resource Manager (ARM) فقط.

المتطلبات

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