مشاركة عبر

Update-ServiceFabricApplicationUpgrade

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

تعديل وصف الترقية لترقية تطبيق نشط.

بناء الجملة

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

الوصف

يقوم الأمر cmdlet Update-ServiceFabricApplicationUpgrade بتعديل معلمات وصف ترقية التطبيق بينما لا تزال الترقية نشطة. يكتشف Service Fabric التغييرات ويطبقها وفقا لقيمة UpgradeStatusPollInterval ، كما هو محدد في بيان نظام المجموعة. باستثناء نهج التقييم الصحي، يقوم cmdlet هذا بتحديث المعلمات التي تحددها فقط. لا تزال المعلمات غير المحددة غير متأثرة. يجب تحديث نهج تقييم الصحة التالية معا، وليس بشكل فردي:

  • ConsiderWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

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

أمثلة

مثال 1: تحديث قيمة لترقية تطبيق

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

يعين هذا الأمر قيمة مهلة التحقق من مجموعة النسخ المتماثلة إلى 0 للترقية المعلقة على fabric:/MyApplication. يترك التحديث كافة قيم الترقية الأخرى وحدها.

المعلمات

-ApplicationName

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

النوع:Uri
Position:0
القيمة الافتراضية: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
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-Force

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

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

-ForceRestart

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

النوع:Boolean
Position:Named
القيمة الافتراضية: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 للحصول على التفاصيل.

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

-MaxPercentUnhealthyDeployedApplications

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

النوع:Byte
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

-TimeoutSec

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

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

-UpgradeDomainTimeoutSec

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

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

-UpgradeMode

تحديد UpgradeMode الجديد للترقية.

النوع:RollingUpgradeMode
القيم المقبولة:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-UpgradeReplicaSetCheckTimeoutSec

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

النوع:UInt32
Position:Named
القيمة الافتراضية: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