Start-ServiceFabricApplicationUpgrade
ترقية تطبيق 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