مشاركة عبر

Start-ServiceFabricApplicationUpgrade

  • ‏‏المرجع
الوحدة النمطية:
ServiceFabric

ترقية تطبيق Service Fabric إلى ApplicationTypeVersion محدد.

بناء الجملة

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

الوصف

يقوم الأمر cmdlet Start-ServiceFabricApplicationUpgrade بترقية تطبيق Service Fabric. قبل استخدام cmdlet هذا، تحتاج إلى نسخ حزمة التطبيق المحدثة إلى مخزن الصور وتسجيل نوع التطبيق المحدث. استخدم Copy-ServiceFabricApplicationPackage لنسخ حزمة التطبيق إلى مخزن الصور. استخدم الأمر cmdlet Register-ServiceFabricApplicationType لتسجيل نوع التطبيق المحدث.

يبدأ cmdlet هذا الترقية على نظام المجموعة.

لا يتم الاحتفاظ ب ApplicationParameters عبر ترقية التطبيق. للحفاظ على معلمات التطبيق الحالية، يجب على المستخدم الحصول على المعلمات أولا وتمريرها إلى استدعاء واجهة برمجة تطبيقات الترقية، كما هو موضح في المثال 1 أدناه.

لمزيد من المعلومات حول ترقيات تطبيق Service Fabric، راجع الوثائق المفاهيمية.

قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام Connect-ServiceFabricCluster cmdlet.

أمثلة

مثال 1: الحصول على معلمات التطبيق لتمريرها إلى استدعاء الترقية

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

مثال 2: ترقية تطبيق

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

يستخدم الأمر الأول Copy-ServiceFabricApplicationPackage cmdlet لنسخ حزمة التطبيق المحدثة إلى مخزن الصور.

يستخدم الأمر الثاني Cmdlet Register-ServiceFabricApplicationType لتسجيل نوع التطبيق المحدث.

يقوم الأمر الثالث بترقية التطبيق. يقوم الأمر بإجراء ترقية يدوية غير مراقبة، والتي تتضمن إعادة تشغيل الخادم الذي يستضيف التطبيق.

المعلمات

-ApplicationName

يحدد معرف المورد الموحد (URI) لتطبيق Service Fabric. يقوم cmdlet بترقية التطبيق الذي يحتوي على URI الذي تحدده.

النوع:Uri
Position:0
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ApplicationParameter

تحديد التجاوزات لمعلمات التطبيق كأزواج الاسم/القيمة.

النوع:Hashtable
Position:2
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ApplicationTypeVersion

يحدد إصدار نوع تطبيق Service Fabric. يقوم cmdlet بترقية التطبيق إلى الإصدار الذي تحدده.

النوع:String
Position:1
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-Confirm

يطالبك بالتأكيد قبل تشغيل cmdlet.

النوع:SwitchParameter
الأسماء المستعارة:cf
Position:Named
القيمة الافتراضية:False
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ConsiderWarningAsError

يشير إلى ما إذا كان يجب التعامل مع حدث حماية تحذير كحدث خطأ أثناء تقييم السلامة.

النوع:Boolean
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-DefaultServiceTypeHealthPolicy

تحدد النهج الصحية لنوع الخدمة الافتراضي المراد استخدامه للترقية المراقبة بالتنسيق MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. على سبيل المثال، يشير 5,10,15 إلى القيم التالية:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-FailureAction

تحديد الإجراء الذي يجب اتخاذه إذا فشلت الترقية المراقبة. القيم المقبولة لهذه المعلمة هي:

  • العودة إلى الحالة السابقة
  • يدوي
النوع:UpgradeFailureAction
القيم المقبولة:Invalid, Rollback, Manual
Position:Named
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-Force

يشير إلى أن cmdlet هذا يتخطى رسالة التحذير ويجبر الترقية.

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ForceRestart

يشير إلى إعادة تشغيل مضيف الخدمة حتى إذا كانت الترقية تغيير التكوين فقط.

النوع:SwitchParameter
Position:3
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-HealthCheckRetryTimeoutSec

تحديد المدة، بالثوان، التي بعد ذلك يعيد Service Fabric محاولة التحقق من الصحة إذا فشل فحص الصحة السابق.

النوع:UInt32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-HealthCheckStableDurationSec

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

النوع:UInt32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-HealthCheckWaitDurationSec

يحدد المدة، بالثوان، التي ينتظرها Service Fabric قبل إجراء فحص السلامة الأولي بعد الانتهاء من الترقية على مجال الترقية.

النوع:UInt32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-InstanceCloseDelayDurationSec

يحدد المدة بالثوان، للانتظار قبل إغلاق مثيل عديم الحالة يتأثر بترقية التطبيق، للسماح للطلبات النشطة بالاستنزاف بأمان. مدة الانتظار هذه فعالة فقط لمثيلات تلك الخدمات عديمة الحالة التي تحتوي على قيمة غير صفرية تم تكوينها ل InstanceCloseDelayDuration، وستتجاوز القيمة المكونة مسبقا. راجع InstanceCloseDelayDuration (في New-ServiceFabricService) للحصول على التفاصيل.

النوع:UInt32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-MaxPercentUnhealthyDeployedApplications

تحديد النسبة المئوية القصوى لمثيلات التطبيق المنشورة على العقد في نظام المجموعة التي تحتوي على حالة خطأ صحية قبل أن تكون حالة صحة التطبيق للمجموعة خطأ.

النوع:Byte
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-Monitored

يشير إلى أن وضع الترقية مراقب. بعد أن ينتهي الأمر من الترقية لمجال ترقية ما، إذا كانت صحة مجال الترقية، ونظام المجموعة تفي بالنُهج الصحية التي تحددها، فإن Service Fabric تقوم بترقية مجال الترقية التالي. إذا فشل مجال الترقية أو نظام المجموعة في تلبية النهج الصحية، فستفشل الترقية وتقوم Service Fabric بإرجاع الترقية إلى مجال الترقية أو تعود إلى الوضع اليدوي وفقاً للنهج المحدد. هذا هو الوضع الموصى به لترقيات التطبيق في بيئة الإنتاج.

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ReplicaQuorumTimeoutSec

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

تم إهمال هذه المعلمة. حدد المعلمة UpgradeReplicaSetCheckTimeoutSec بدلا من ذلك.

النوع:UInt32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-RestartProcess

يشير إلى إعادة تشغيل مضيف الخدمة كجزء من الترقية.

تم إهمال هذه المعلمة. حدد المعلمة ForceRestart بدلا من ذلك.

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ServiceTypeHealthPolicyMap

يحدد مخطط النهج الصحي لاستخدامه لأنواع الخدمات المختلفة كجدول تجزئة بالتنسيق التالي: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. على سبيل المثال:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

النوع:Hashtable
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-SortOrder

يحدد الترتيب الذي تنتقل به الترقية من خلال نظام المجموعة.

القيم المحتملة هي:

  • Invalid - يشير إلى أن ترتيب الفرز هذا غير صحيح. تحتوي جميع تعدادات Service Fabric على النوع غير الصالح.
  • Default - يشير إلى أنه سيتم استخدام ترتيب الفرز الافتراضي (كما هو محدد في بيان نظام المجموعة).
  • Numeric - يشير إلى أنه سيتم استخدام ترتيب الفرز الرقمي للأمام (أسماء UD التي تم فرزها كأرقام).
  • Lexicographical - يشير إلى أنه سيتم استخدام ترتيب الفرز المعجمي الأمامي (أسماء UD التي تم فرزها كسلاسل).
  • ReverseNumeric - يشير إلى أنه سيتم استخدام ترتيب الفرز الرقمي العكسي (أسماء UD التي تم فرزها كأرقام).
  • ReverseLexicographical- يشير إلى أنه سيتم استخدام ترتيب الفرز المعجمي العكسي (أسماء UD التي تم فرزها كسلاسل).
النوع:UpgradeSortOrder
القيم المقبولة:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:5
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-TimeoutSec

تحديد فترة المهلة، بالثوان، للعملية.

النوع:Int32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-UnmonitoredAuto

يشير إلى أن وضع الترقية تلقائي غير مراقب. بعد قيام Service Fabric بترقية مجال ترقية، تقوم Service Fabric بترقية مجال الترقية التالي بغض النظر عن حالة صحة التطبيق. هذا الوضع غير موصى به للإنتاج، وهو مفيد فقط أثناء تطوير أحد التطبيقات.

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-UnmonitoredManual

يشير إلى أن وضع الترقية يدوي غير مراقب. بعد أن تقوم Service Fabric بترقية مجال ترقية، تنتظر ترقية مجال الترقية التالي باستخدام الأمر Resume-ServiceFabricApplicationUpgrade.

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-UpgradeDomainTimeoutSec

يحدد الحد الأقصى للوقت، بالثوان، الذي يستغرقه Service Fabric لترقية مجال ترقية واحد. بعد هذه الفترة، تفشل الترقية.

النوع:UInt32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-UpgradeReplicaSetCheckTimeoutSec

يحدد الحد الأقصى للوقت الذي ينتظره Service Fabric لإعادة تكوين الخدمة في حالة آمنة، إن لم يكن بالفعل في حالة آمنة، قبل أن يستمر Service Fabric في الترقية.

النوع:UInt32
Position:4
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-UpgradeTimeoutSec

يحدد الحد الأقصى للوقت، بالثوان، الذي يستغرقه Service Fabric للترقية بأكملها. بعد هذه الفترة، تفشل الترقية.

النوع:UInt32
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-WhatIf

تعرض ما سيحدث عند تشغيل الأمر cmdlet. لم يتم تشغيل cmdlet.

النوع:SwitchParameter
الأسماء المستعارة:wi
Position:Named
القيمة الافتراضية:False
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

الإدخالات

None

المخرجات

System.Object