AzurePowerShell@2 - مهمة Azure PowerShell v2
استخدم هذه المهمة لتشغيل برنامج نصي PowerShell داخل بيئة Azure. تتم مصادقة سياق Azure مع اتصال خدمة Azure Resource Manager المتوفر.
بناء الجملة
# Azure PowerShell v2
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@2
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'. Required. Script Type. Default: FilePath.
#ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path.
#Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script.
#ScriptArguments: # string. Script Arguments.
#azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.
الإدخالات
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
.
المعلمات الإضافية لتمريرها إلى PowerShell. يمكن أن تكون هذه إما معلمات ترتيبية أو مسماة.
azurePowerShellVersion
- إصدار Azure PowerShell
الاسم المستعار للإدخل: TargetAzurePs
. string
. القيم المسموح بها: LatestVersion
(أحدث إصدار مثبت)، OtherVersion
(تحديد إصدار آخر). القيمة الافتراضية: OtherVersion
.
في حالة الوكلاء المستضافين، تكون إصدارات Azure PowerShell المدعومة هي 2.1.0
و 4.2.1
3.8.0
5.1.1
و و.6.7.0
لاختيار أحدث إصدار متوفر على العامل، حدد LatestVersion
(أحدث إصدار مثبت).
بالنسبة للوكلاء الخاصين، يمكنك تحديد إصدار مفضل من Azure PowerShell باستخدام OtherVersion
(تحديد إصدار آخر).
preferredAzurePowerShellVersion
- إصدار Azure PowerShell المفضل
الاسم المستعار للإدخل: CustomTargetAzurePs
. string
. مطلوب عند TargetAzurePs = OtherVersion
.
يجب أن يكون إصدار Azure PowerShell المفضل إصدارا دلاليا مناسبا على سبيل المثال. 1.2.3.
. Regex مثل 2.\*,2.3.\*
غير مدعوم. يدعم الوكلاء المستضافون حاليا إصدارات 2.1.0
3.8.0
4.2.1
5.1.1
وحدة Azure، وAzureRM، وإصدارات الوحدة النمطية2.1.0
، و3.8.0
، 4.2.1
و، 5.1.1
6.7.0
خيارات التحكم بالمهمة
تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.
متغيرات الإخراج
لا شيء
المتطلبات
المتطلبات | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي |
يعمل على | Agent, DeploymentGroup |
المطالب | يجب أن يكون لدى العوامل المستضافة ذاتيا قدرات تطابق الطلبات التالية لتشغيل المهام التي تستخدم هذه المهمة: azureps |
القدرات | لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | 1.95.0 أو أحدث |
فئة المهمة | نشر |