Update-ServiceFabricService

الوحدة النمطية:

ServiceFabric

التحديثات خدمة Service Fabric.

بناء الجملة

Update-ServiceFabricService
      [-Stateless]
      [-ServiceName] <Uri>
      [-InstanceCount <Int32>]
      [-MinInstanceCount <Int32>]
      [-MinInstancePercentage <Int32>]
      [-InstanceLifecycleDescription <InstanceLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-InstanceCloseDelayDuration <TimeSpan>]
      [-InstanceRestartWaitDuration <TimeSpan>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-ServiceFabricService
      [-Stateful]
      [-ServiceName] <Uri>
      [-TargetReplicaSetSize <Int32>]
      [-MinReplicaSetSize <Int32>]
      [-ReplicaRestartWaitDuration <TimeSpan>]
      [-QuorumLossWaitDuration <TimeSpan>]
      [-StandByReplicaKeepDuration <TimeSpan>]
      [-ServicePlacementTimeLimit <TimeSpan>]
      [-DropSourceReplicaOnMove <Boolean>]
      [-ReplicaLifecycleDescription <ReplicaLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

الوصف

يقوم الأمر cmdlet Update-ServiceFabricService بتحديث خصائص خدمة Service Fabric قيد التشغيل. مجموعة الخصائص التي يمكن تحديثها هي مجموعة فرعية من الخصائص التي تم تحديدها في وقت إنشاء الخدمة (باستخدام New-ServiceFabricService أو New-ServiceFabricServiceFromTemplate). يمكنك الحصول على الخصائص الحالية للخدمة باستخدام Get-ServiceFabricServiceDescription.

يرجى ملاحظة أن تحديث خصائص خدمة قيد التشغيل يختلف عن ترقية الخدمة باستخدام Start-ServiceFabricApplicationUpgrade. ترقية الخدمة (أي التطبيق) هي مهمة خلفية طويلة الأمد تتضمن نقل التطبيق الخاص بك، من إصدار إلى آخر، مجال ترقية واحد في كل مرة. يرجى مراجعة ترقية تطبيق Service Fabric لمزيد من التفاصيل.

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

أمثلة

مثال 1: تحديث خدمة ذات حالة

PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5

يحدث هذا الأمر MinReplicaSetSize و TargetReplicaSetSize لخدمة Fabric قيد التشغيل إلى ثلاثة (3) وخمسة (5).

مثال 2: تحديث خدمة عديمة الحالة

PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1

يحدث هذا الأمر عدد المثيلات لخدمة Fabric قيد التشغيل إلى قيمة -1.

مثال 3: تحديث قيود الموضع

PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"

يحدث هذا الأمر قيود الموضع.

مثال 4: تحديث مقاييس التحميل الافتراضية

PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -Metric @("CPU,High,10")
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Metric @("CPU,High,10,1")

يقوم الأمر الأول بتحديث مقاييس التحميل الافتراضية لخدمة عديمة الحالة.

يحدث الأمر الثاني مقاييس التحميل الافتراضية لخدمة ذات حالة.

مثال 5: تحديث نهج الموضع

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")

يقوم هذا الأمر بتحديث نهج الموضع.

مثال 6: تحديث ارتباط الخدمة

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")

يحدث هذا الأمر ارتباط الخدمة.

مثال 7: تحديث اسم DNS للخدمة

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns

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

المعلمات

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Correlation

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultMoveCost

يحدد تكلفة النقل الافتراضية المحدثة التي تمتلكها النسخ المتماثلة عند إنشائها. القيم المقبولة لهذه المعلمة هي:

• صفر
• منخفض
• متوسط
• درجة عالية

لمزيد من التفاصيل حول تكلفة النقل، راجع تكلفة حركة الخدمة للتأثير على خيارات Resource Manager المجموعة.

Type:	String
Accepted values:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DropSourceReplicaOnMove

تمكين النسخ المتماثلة الثانوية المصدر ليتم إسقاطها قبل انتهاء النسخ المتماثلة الثانوية الجديدة من الإنشاء.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

يجبر الأمر على التشغيل دون طلب تأكيد المستخدم.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceCloseDelayDuration

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

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceCount

تحديد عدد المثيلات المحدثة لخدمة Service Fabric عديمة الحالة. لا تحدد هذه المعلمة للخدمات ذات الحالة.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceLifecycleDescription

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

Type:	InstanceLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceRestartWaitDuration

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

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metric

تحديد صفيف المقاييس المحدثة التي تبلغ الخدمة بها. لمعرفة المزيد حول المقاييس، راجع إدارة استهلاك الموارد وتحميلها في Service Fabric باستخدام المقاييس.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinInstanceCount

يحدد الحد الأدنى المحدث لعدد مثيلات قسم الخدمة عديم الحالة. راجع MinInstanceCount (في New-ServiceFabricService) للحصول على التفاصيل. لا تحدد هذه المعلمة للخدمات ذات الحالة.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinInstancePercentage

تحديد النسبة المئوية الدنيا المحدثة ل InstanceCount لقسم خدمة عديم الحالة. راجع MinInstancePercentage (في New-ServiceFabricService) للحصول على التفاصيل. لا تحدد هذه المعلمة للخدمات ذات الحالة.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinReplicaSetSize

يحدد الحد الأدنى المحدث لحجم مجموعة النسخ المتماثلة لخدمة Service Fabric ذات الحالة. يجب أن تكون القيمة أقل من TargetReplicaSetSize لهذه الخدمة. لمزيد من التفاصيل، راجع StatefulServiceDescription.MinReplicaSetSize.

لا تحدد هذه المعلمة للخدمات عديمة الحالة.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementConstraints

تحديد قيد الموضع المحدث للخدمة. لمعرفة المزيد حول قيود الموضع، راجع قيود الموضع وخصائص العقدة.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementPolicy

تحديد صفيف محدث من نهج المواضع لخدمة ما. لمعرفة المزيد حول PlacementPolicy، راجع نهج الموضع لخدمات نسيج الخدمة.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QuorumLossWaitDuration

يحدد المدة المحدثة، ككائن TimeSpan ، التي ينتظرها Service Fabric قبل أن يعلن عن فقدان البيانات لقسم الخدمة.

للحصول على كائن TimeSpan ، استخدم الأمر Cmdlet New-TimeSpan . لمزيد من المعلومات، اكتب Get-Help New-TimeSpan.

لمعرفة المزيد حول المعلمة QuorumLossWaitDuration، راجع StatefulServiceDescription.QuorumLossWaitDuration.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicaLifecycleDescription

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

Type:	ReplicaLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicaRestartWaitDuration

يحدد الفاصل الزمني المحدث، ككائن TimeSpan ، الذي ينتظر Service Fabric حتى تتم إعادة تشغيل النسخة المتماثلة قبل أن تنشئ نسخة متماثلة بديلة. للحصول على كائن TimeSpan ، استخدم الأمر Cmdlet New-TimeSpan .

لمعرفة المزيد حول QuorumLossWaitDuration، راجع StatefulServiceDescription.ReplicaRestartWaitDuration.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceDnsName

تحديد اسم DNS المحدث للخدمة.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceName

يحدد URI لخدمة Service Fabric التي تحتاج خصائصها إلى تحديث.

Type:	Uri
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServicePlacementTimeLimit

تعيين حد وقت وضع الخدمة.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StandByReplicaKeepDuration

تحديد مدة الاحتفاظ بالنسخة المتماثلة الاحتياطية المحدثة ككائن TimeSpan .

لمعرفة المزيد حول QuorumLossWaitDuration، راجع StatefulServiceDescription.StandByReplicaKeepDuration.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Stateful

يشير إلى أن الخدمة هي خدمة ذات حالة Service Fabric.

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Stateless

يشير إلى أن الخدمة هي خدمة بدون حالة Service Fabric.

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TagsRequiredToPlace

يعلن عن العلامات المطلوبة لوضع خدمة. يكون مفيدًا للتأثير ديناميكيًا على موضع الخدمة. لمزيد من المعلومات، راجع علامات العقدة الديناميكية ل Service Fabric.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagsRequiredToRun

يعلن عن العلامات المطلوبة لوضع الخدمة وتشغيلها. يكون مفيدًا للتأثير ديناميكيًا على موضع الخدمة وتشغيلها. لمزيد من المعلومات، راجع علامات العقدة الديناميكية ل Service Fabric

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetReplicaSetSize

يحدد حجم مجموعة النسخ المتماثلة الهدف المحدث لخدمة Service Fabric ذات الحالة. لمزيد من التفاصيل، راجع StatefulServiceDescription.TargetReplicaSetSize.

لا تحدد هذه المعلمة لخدمة عديمة الحالة.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

الإدخالات

System.Uri

المخرجات

System.Object

الارتباطات المرتبطة

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricService
• New-ServiceFabricService
• Remove-ServiceFabricService
• Resolve-ServiceFabricService