مشاركة عبر

New-ServiceFabricApplication

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

إنشاء تطبيق Service Fabric.

بناء الجملة

New-ServiceFabricApplication
   [-ApplicationName] <Uri>
   [-ApplicationTypeName] <String>
   [-ApplicationTypeVersion] <String>
   [-ApplicationParameter <Hashtable>]
   [-MaximumNodes <Int64>]
   [-MinimumNodes <Int64>]
   [-Metrics <String[]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

الوصف

ينشئ الأمر cmdlet New-ServiceFabricApplication تطبيق Service Fabric لنوع تطبيق مسجل. استخدم الأمر cmdlet Register-ServiceFabricApplicationType لتسجيل نوع تطبيق.

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

أمثلة

مثال 1: إنشاء تطبيق

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"

ينشئ هذا الأمر تطبيقا من النوع PersistentToDoListApp. التطبيق هو الإصدار 1.0. يأتي نوع التطبيق والإصدار من بيان التطبيق في حزمة التطبيق التي تم استخدامها عند تسجيل التطبيق باستخدام Register-ServiceFabricApplicationType cmdlet.

مثال 2: إنشاء تطبيق عن طريق تجاوز قيم المعلمات الافتراضية في بيان التطبيق

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}

ينشئ هذا الأمر تطبيقا من النوع PersistentToDoListApp والإصدار 1.0 مع قيم تم تجاوزها للمعلمات CustomParameter1 وCustomParameter2. يجب أن توجد أسماء المعلمات هذه في بيان التطبيق لحزمة التطبيق التي تم استخدامها عند تسجيل التطبيق باستخدام Register-ServiceFabricApplicationType cmdlet.

المعلمات

-ApplicationName

يحدد معرف المورد الموحد (URI) لتطبيق Service Fabric. ينشئ cmdlet تطبيق Service Fabric بالاسم الذي تحدده.

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

-ApplicationParameter

تحديد التجاوزات لمعلمات التطبيق المحددة في بيان التطبيق كأزواج مفتاح/قيمة. ينشئ cmdlet تطبيق Service Fabric من نوع التطبيق ويستخدم القيم التي تم تجاوزها لهذه المعلمات. يجب أن تكون المعلمات التي يتم تجاوزها هنا موجودة في بيان التطبيق.

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

-ApplicationTypeName

يحدد اسم نوع تطبيق Service Fabric. ينشئ cmdlet تطبيق Service Fabric من نوع التطبيق الذي تحدده.

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

-ApplicationTypeVersion

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

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

-MaximumNodes

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

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

-Metrics

تحديد صفيف من المقاييس. يتم استخدام هذه المقاييس من قبل مجموعة Service Fabric Resource Manager لإدارة الموارد في نظام المجموعة. لمزيد من المعلومات حول المقاييس وإدارة الموارد في Service Fabric، راجع Service Fabric Cluster Resource Manager Introduction. يمكن لكل مقياس اتباع النمط MetricName أو NodeReservationCapacity أو MaximumNodeCapacity أو TotalApplicationCapacity أو يمكنه تحديد MetricName واستخدام أسماء المعلمات NodeReservationCapacity أو MaximumNodeCapacity أو TotalApplicationCapacity متبوعا بقيمة معلمة، ومفصولة بفاصلة. يمكن أن يظهر كل زوج اسم:قيمة معلمة مرة واحدة على الأكثر.

  • MetricName. تحديد اسم المقياس.
  • NodeReservationCapacity. يحدد مقدار تحميل القياس المحجوز على العقد التي تحتوي على مثيلات لهذا التطبيق. إذا تم تحديد MinimumNodes ، فإن ناتج هذه القيم هو السعة المحجوزة في نظام المجموعة للتطبيق.
  • MaximumNodeCapacity. تحديد الحد الأقصى للتحميل لمثيل من هذا التطبيق على عقدة واحدة. حتى إذا كانت سعة العقدة أكبر من هذه القيمة، فإن Service Fabric تحد من الحمل الإجمالي للنسخ المتماثلة التابعة للتطبيق إلى هذه القيمة.
  • TotalApplicationCapacity. تحديد السعة الإجمالية للتطبيق في نظام المجموعة. يحاول Service Fabric تحديد مجموع أحمال النسخ المتماثلة التابعة للتطبيق إلى هذه القيمة.

أثناء إنشاء التطبيق، يقوم Service Fabric بإجراء عمليات التحقق التالية وسيفشل الأمر إذا لم ينجح:

  • يجب ألا تكون NodeReservationCapacity أكثر من MaximumNodeCapacity.

  • إذا تم تحديد كل من معلمة MinimumNodes ومقياس NodeReservationCapacity، فيجب ألا يكون منتج MinimumNodes وNodeReservationCapacity أكثر من TotalApplicationCapacity. لمزيد من المعلومات، راجع مقاييس التطبيق والتحميل والسعة

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

-MinimumNodes

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

Type:Int64
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

الإدخالات

None

المخرجات

System.Object