IISWebAppDeployment@1 - مهمة توزيع IIS Web App (مهمل) الإصدار 1

استخدم هذه المهمة لنشر IIS Web App باستخدام MSDeploy، ثم إنشاء مواقع الويب وتجمعات التطبيقات أو تحديثها.

هام

تم إهمال هذه المهمة وسيتم إيقافها في 31 يناير 2024. استخدم نشر تطبيق ويب IIS باستخدام WinRM - Viual Studio Marketplace.

بناء الجملة

# IIS Web App deployment (Deprecated) v1
# Deploy using MSDeploy, then create/update websites and app pools.
- task: IISWebAppDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #WinRMProtocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
  # Deployment
    WebDeployPackage: # string. Required. Web Deploy Package. 
    #WebDeployParamFile: # string. Web Deploy Parameter File. 
    #OverRideParams: # string. Override Parameters. 
  # Website
    #CreateWebSite: false # boolean. Create or Update Website. Default: false.
    #WebSiteName: # string. Required when CreateWebSite = true. Website Name. 
    #WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
    #WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
    #WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name. 
    #WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password. 
    #AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
    #AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
    Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
    IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
    Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name. 
    #HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name. 
    #HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name. 
    #SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print. 
  # Application Pool
    #CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
    #AppPoolName: # string. Required when CreateAppPool = true. Name. 
    #DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
    #PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
    #AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional AppCmd.exe Commands. 
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

الإدخالات

EnvironmentName - الات
string. مطلوب

يحدد قائمة مفصولة بفواصل من عناوين IP للجهاز أو FQDNs، جنبا إلى جنب مع المنافذ. يستند المنفذ الافتراضي إلى البروتوكول المحدد، على سبيل المثال dbserver.fabrikam.com أو dbserver_int.fabrikam.com:5986,192.168.12.34:5986. يمكنك أيضا توفير متغير الإخراج للمهام الأخرى، على سبيل المثال $(variableName).

AdminUserName - مسؤول تسجيل الدخول
string.

يحدد تسجيل دخول المسؤول للأجهزة الهدف.

AdminPassword - كلمه المرور
string.

يحدد كلمة مرور المسؤول للأجهزة الهدف. يمكنه قبول المتغيرات المحددة في تعريفات الإنشاء/الإصدار، مثل $(passwordVariable). يمكنك وضع علامة على نوع المتغير على أنه secret لتأمينه.

WinRMProtocol - البروتوكول
string. القيم المسموح بها: Http، . Https

يحدد البروتوكول المستخدم لاتصال WinRM مع الجهاز (الأجهزة). الافتراضي هو HTTPS.

TestCertificate - شهادة الاختبار
boolean. ‏‏اختياري. استخدم عندما WinRMProtocol = Https. القيمة الافتراضية: true.

يحدد خيار تخطي التحقق من صحة شهادة الجهاز من قبل مرجع مصدق موثوق به. المعلمة مطلوبة لبروتوكول WinRM HTTPS .

WebDeployPackage - حزمة نشر الويب
string. مطلوب

يحدد موقع الملف المضغوط Web Deploy (MSDeploy) على الأجهزة الهدف أو على مسار UNC مثل ، \\BudgetIT\WebDeploy\WebDeployPackage.zip. يجب أن يكون مسار UNC متاحا لحساب مسؤول الجهاز. يتم أيضا دعم متغيرات البيئة، مثل $env:windirو $env:systemrootو.$env:windir\FabrikamFibre\Web

WebDeployParamFile - ملف معلمة توزيع الويب
string.

يحدد موقع ملف المعلمة على الأجهزة الهدف أو على مسار UNC. يتم استخدام ملف المعلمة لتجاوز إعدادات تكوين تطبيق الويب، مثل اسم تطبيق ويب IIS أو سلسلة الاتصال قاعدة البيانات.

OverRideParams - تجاوز المعلمات
string.

ستتجاوز المعلمات المحددة هنا المعلمات في ملف MSDeploy zip وملف المعلمة. لتجاوز أكثر من معلمة واحدة، استخدم فاصل أسطر.
على سبيل المثال، "IIS Web Application Name"="Fabrikam" أو "ConnectionString"="Server=localhost;Database=Fabrikam;".

CreateWebSite - إنشاء موقع ويب أو تحديثه
boolean. القيمة الافتراضية: false.

تحديد خيار إنشاء موقع ويب أو تحديث موقع ويب موجود.

WebSiteName - اسم موقع الويب
string. مطلوب عند CreateWebSite = true.

يحدد اسم موقع IIS على الويب الذي سيتم إنشاؤه إذا لم يكن موجودا، أو سيتم تحديثه إذا كان موجودا بالفعل على خادم IIS. يجب أن يكون اسم موقع الويب هو نفسه الذي تم تحديده في ملف حزمة مضغوطة لتوزيع الويب. إذا تم أيضا تحديد ملف معلمة وإعداد تجاوز المعلمات، فيجب أن يكون اسم موقع الويب هو نفسه في إعداد معلمات التجاوز.

WebSitePhysicalPath - المسار الفعلي
string. مطلوب عند CreateWebSite = true. القيمة الافتراضية: %SystemDrive%\inetpub\wwwroot.

يحدد المسار الفعلي حيث يتم تخزين محتوى موقع الويب. يمكن أن يتواجد المحتوى على الكمبيوتر المحلي أو على دليل بعيد أو مشاركة، مثل C:\Fabrikam أو \\ContentShare\Fabrikam.

WebSitePhysicalPathAuth - مصادقة المسار الفعلي
string. مطلوب عند CreateWebSite = true. القيم المسموح بها: WebSiteUserPassThrough (مستخدم التطبيق (المرور))، WebSiteWindowsAuth (مصادقة Windows). القيمة الافتراضية: Application User (Pass-through).

يحدد آلية المصادقة للوصول إلى المسار الفعلي لموقع الويب.

WebSiteAuthUserName - اسم المستخدم
string. مطلوب عند WebSitePhysicalPathAuth = WebSiteWindowsAuth.

يحدد اسم المستخدم للوصول إلى المسار الفعلي لموقع الويب.

WebSiteAuthUserPassword - كلمه المرور
string. ‏‏اختياري. استخدم عندما WebSitePhysicalPathAuth = WebSiteWindowsAuth.

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

AddBinding - إضافة ربط
boolean. ‏‏اختياري. استخدم عندما CreateWebSite = true. القيمة الافتراضية: true.

يحدد خيار إضافة ربط المنفذ لموقع الويب.

AssignDuplicateBinding - تعيين ربط مكرر
boolean. ‏‏اختياري. استخدم عندما AddBinding = true. القيمة الافتراضية: false.

يحدد خيار إضافة الروابط المحددة هنا (حتى إذا كان هناك موقع ويب آخر بنفس الروابط). إذا كانت هناك تعارضات ملزمة، فسيبدأ واحد فقط من مواقع الويب.

Protocol - البروتوكول
string. مطلوب عند AddBinding = true. القيم المسموح بها: https، . http القيمة الافتراضية: http.

يحدد إما HTTP لموقع الويب ليكون لديه ربط HTTP أو HTTPS لموقع الويب ليكون له ربط طبقة مآخذ توصيل آمنة (SSL).

IPAddress - عنوان IP
string. مطلوب عند AddBinding = true. القيمة الافتراضية: All Unassigned.

تحديد عنوان IP يمكن للمستخدمين استخدامه للوصول إلى موقع الويب. إذا تم تحديد All Unassigned ، فسيستجيب الموقع لطلبات جميع عناوين IP على المنفذ واسم المضيف الاختياري المحدد للموقع. لن يستجيب الموقع للطلبات إذا كان موقع آخر على الخادم يحتوي على ربط على نفس المنفذ ولكن بعنوان IP محدد.

Port - منفذ
string. مطلوب عند AddBinding = true. القيمة الافتراضية: 80.

يحدد المنفذ الذي يجب على Hypertext Transfer Protocol Stack (HTTP.sys) مراقبة الطلبات المقدمة إلى موقع الويب هذا.

ServerNameIndication - إشارة اسم الخادم مطلوبة
boolean. ‏‏اختياري. استخدم عندما Protocol = https. القيمة الافتراضية: false.

تحديد ما إذا كان موقع الويب يتطلب إشارة اسم الخادم (SNI). يقوم SNI بتوسيع بروتوكولات SSL وTLS للإشارة إلى اسم المضيف الذي يحاول العميل الاتصال به. يسمح لعدة مواقع ويب آمنة بشهادات مختلفة باستخدام نفس عنوان IP.

HostNameWithOutSNI - اسم المضيف
string. ‏‏اختياري. استخدم عندما ServerNameIndication = false.

تعيين اسم مضيف واحد أو أكثر (أو أسماء المجالات) إلى كمبيوتر يستخدم عنوان IP واحدا. إذا تم تحديد اسم مضيف، فيجب على العملاء استخدام اسم المضيف بدلا من عنوان IP للوصول إلى موقع الويب.

HostNameWithHttp - اسم المضيف
string. ‏‏اختياري. استخدم عندما Protocol = http.

تعيين اسم مضيف واحد أو أكثر (أو أسماء المجالات) إلى كمبيوتر يستخدم عنوان IP واحدا. إذا تم تحديد اسم مضيف، فيجب على العملاء استخدام اسم المضيف بدلا من عنوان IP للوصول إلى موقع الويب.

HostNameWithSNI - اسم المضيف
string. مطلوب عند ServerNameIndication = true.

تعيين اسم مضيف واحد أو أكثر (أو أسماء المجالات) إلى كمبيوتر يستخدم عنوان IP واحدا. إذا تم تحديد اسم مضيف، فيجب على العملاء استخدام اسم المضيف بدلا من عنوان IP للوصول إلى موقع الويب.

SSLCertThumbPrint - طباعة إبهام شهادة SSL
string. مطلوب عند Protocol = https.

يحدد بصمة الإبهام لشهادة طبقة مأخذ التوصيل الآمنة التي سيستخدمها موقع الويب. يجب أن تكون الشهادة مثبتة بالفعل على الجهاز وأن تكون موجودة ضمن مخزن Local Computer Personal.

CreateAppPool - إنشاء تجمع التطبيقات أو تحديثه
boolean. القيمة الافتراضية: false.

يحدد خيار إنشاء تجمع تطبيقات أو لتحديث تجمع تطبيقات موجود.

AppPoolName - اسم
string. مطلوب عند CreateAppPool = true.

يحدد اسم تجمع تطبيقات IIS المراد إنشاؤه أو تحديثه. سيتم تحديث تجمع التطبيقات الموجود بالإعدادات المحددة.

DotNetVersion - إصدار .NET
string. مطلوب عند CreateAppPool = true. القيم المسموح بها: v4.0، ، v2.0No Managed Code. القيمة الافتراضية: v4.0.

يحدد إصدار .NET Framework الذي يتم تحميله بواسطة تجمع التطبيقات هذا. إذا كانت التطبيقات المعينة إلى تجمع التطبيقات هذا لا تحتوي على تعليمات برمجية مدارة، فحدد الخيار No Managed Code من القائمة.

PipeLineMode - وضع البنية الأساسية لبرنامج ربط العمليات التجارية المدارة
string. مطلوب عند CreateAppPool = true. القيم المسموح بها: Integrated، . Classic القيمة الافتراضية: Integrated.

يحدد وضع البنية الأساسية لبرنامج ربط العمليات التجارية المدارة كيفية معالجة IIS لطلبات المحتوى المدار. استخدم الوضع الكلاسيكي فقط عندما لا يمكن تشغيل التطبيقات في تجمع التطبيقات في الوضع المتكامل.

AppPoolIdentity - الهويه
string. مطلوب عند CreateAppPool = true. القيم المسموح بها: ApplicationPoolIdentity، LocalService، LocalSystem، NetworkService، SpecificUser (حساب مخصص). القيمة الافتراضية: ApplicationPoolIdentity.

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

AppPoolUsername - المستخدم
string. مطلوب عند AppPoolIdentity = SpecificUser.

AppPoolPassword - كلمه المرور
string. ‏‏اختياري. استخدم عندما AppPoolIdentity = SpecificUser.

إذا كنت تستخدم gMSA، فهذا غير مطلوب.

AppCmdCommands - أوامر AppCmd.exe إضافية
string.

يحدد أوامر إضافية AppCmd.exe لتعيين موقع الويب أو خصائص تجمع التطبيقات. لأكثر من أمر واحد، استخدم فاصل أسطر.
على سبيل المثال:
<قائمة تجمعات التطبيقات>
<قائمة المواقع>

DeployInParallel - التوزيع بالتوازي
boolean. القيمة الافتراضية: true.

إذا تم تعيينه إلى true، يتم نشر تطبيق ويب بالتوازي على الأجهزة الهدف.

ResourceFilteringMethod - تحديد الأجهزة حسب
string. القيم المسموح بها: machineNames (أسماء الأجهزة)، tags. القيمة الافتراضية: machineNames.

‏‏اختياري. يحدد مجموعة فرعية من الأجهزة عن طريق توفير أسماء الأجهزة أو علاماتها.

MachineFilter - التوزيع إلى الأجهزة
string.

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

يحدد قائمة بالأجهزة، مثل dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 أو العلامات، مثل Role:DB; OS:Win8.1. إذا تم توفير علامات متعددة، فسيتم تشغيل المهمة في جميع الأجهزة ذات العلامات المحددة. بالنسبة إلى مجموعات موارد Azure، حدد اسم الجهاز الظاهري، مثل ffweb, ffdb. يقوم الافتراضي بتشغيل المهمة في جميع الأجهزة.

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

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

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

لا شيء

الملاحظات

هام

تم إهمال هذه المهمة. استخدم نشر تطبيق ويب IIS باستخدام WinRM - Viual Studio Marketplace.

المتطلبات

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