AzureCLI@2 - مهمة Azure CLI v2

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

تشغيل أوامر Azure CLI مقابل اشتراك Azure في برنامج نصي PowerShell Core/shell عند التشغيل على عامل Linux. أو قم بتشغيل أوامر 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.

# 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.

# 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.

اتصال Azure Resource Manager
الاسم المستعار للإدخل: connectedServiceNameARM. string. مطلوب.

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

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

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

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

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

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

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

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

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

البرنامج النصي المضمن
string. مطلوب عند 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. string.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

اي.