Get-ServiceFabricApplication

يحصل على التطبيق (التطبيقات) على مجموعة Service Fabric.

بناء الجملة

Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-ContinuationToken <String>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-GetSinglePage]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

الوصف

يحصل الأمر cmdlet Get-ServiceFabricApplication على التطبيق (التطبيقات) على مجموعة Service Fabric. بشكل افتراضي، لا توجد قيود على عدد نتائج الاستعلام التي يمكن إرجاعها بواسطة هذا الاستعلام، بغض النظر عن تكوين حجم الرسالة الأقصى؛ في حين أن هذا استعلام مصفح، على عكس استدعاءات REST أو C# المكافئة، فإن السلوك الافتراضي لهذا الاستعلام هو التكرار عبر جميع الصفحات التي تم إرجاعها بشفافية. يقوم الخيار GetSinglePage بتكوين هذا الاستعلام لإرجاع صفحة واحدة.

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

أمثلة

مثال 1: الحصول على جميع التطبيقات

PS C:\> Get-ServiceFabricApplication

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : { "ServiceInstanceCount" = "4" }

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

يحصل هذا الأمر على جميع التطبيقات في نظام المجموعة.

مثال 2: الحصول على التطبيق حسب الاسم

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/samples/PQueueApp1

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

يحصل هذا الأمر على التطبيق المحدد مع اسم fabric:/samples/PQueueApp1.

مثال 3: الحصول على التطبيق حسب اسم النوع

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

يحصل هذا الأمر على تطبيق (تطبيقات) Service Fabric الذي يكون اسم نوعه PersistentQueueApp.

مثال 4: الحصول على التطبيق حسب نوع التعريف

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

يحصل هذا الأمر على تطبيق (تطبيقات) Service Fabric التي تم تعريفها بواسطة وصف تطبيق Service Fabric.

مثال 5: الحصول على التطبيق مع أقصى النتائج

PS C:\>Get-ServiceFabricApplication -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : "ServiceInstanceCount" = "4"
                            

VERBOSE: Continuation Token: fabric:/samples/CalculatorAppWithAppParameters

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

مثال 6: الحصول على التطبيق مع رمز المتابعة المميز

PS C:\>Get-ServiceFabricApplication -ContinuationToken fabric:/samples/CalculatorAppWithAppParameters -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

VERBOSE: Continuation Token:

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

مثال 7: الحصول على التطبيق حسب الاسم مع استبعاد معلمات التطبيق

PS C:\>Get-ServiceFabricApplication -ApplicationName fabric:/samples/CalculatorAppWithAppParameters -ExcludeApplicationParameters

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

يحصل هذا الأمر على تطبيق Service Fabric الذي يطابق اسم التطبيق المقدم. كما هو ملاحظ من المثال 5، يحتوي هذا التطبيق على معلمات التطبيق، ولكن يتم استبعاده من النتيجة (النتائج) التي تم إرجاعها بسبب علامة "ExcludeApplicationParameters"

المعلمات

-ApplicationDefinitionKindFilter

تحديد عامل التصفية ل ApplicationDefinitionKindFilter استنادا إلى كيفية تعريف التطبيق. يمكن الحصول على القيمة من الأعضاء أو عمليات البت على أعضاء ApplicationDefinitionKindFilter. إرجاع التطبيقات التي تطابق عامل التصفية فقط. على الأكثر يمكن تحديد أحد ApplicationName أو ApplicationTypeName أو ApplicationDefinitionKindFilter. إذا لم يتم تحديد عامل تصفية، يتم إرجاع جميع التطبيقات.

Type:ApplicationDefinitionKindFilter
Accepted values:Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

يحدد معرف المورد الموحد (URI) لتطبيق Service Fabric. يحصل cmdlet على التطبيق الذي يحتوي على URI المحدد. على الأكثر يمكن تحديد أحد ApplicationName أو ApplicationTypeName أو ApplicationDefinitionKindFilter. إذا لم يتم تحديد عامل تصفية، يتم إرجاع جميع التطبيقات.

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

-ApplicationTypeName

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

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

-ContinuationToken

يحدد رمز المتابعة المميز الذي يمكن استخدامه لاسترداد الصفحة التالية من نتائج الاستعلام.

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

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

-ExcludeApplicationParameters

يحدد ما إذا كان سيتم استبعاد معلمات التطبيق من النتيجة.

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

-GetSinglePage

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

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

-MaxResults

تحديد الحد الأقصى لعدد عناصر النتائج التي يمكن إرجاعها لكل صفحة. يحدد هذا الحد الأعلى لعدد النتائج التي تم إرجاعها، وليس الحد الأدنى. على سبيل المثال، إذا كانت الصفحة تناسب على الأكثر 1000 عنصر تم إرجاعها وفقا للقيود القصوى لحجم الرسالة المحددة في التكوين، وتم تعيين قيمة MaxResults إلى 2000، فسيتم إرجاع 1000 نتيجة فقط، حتى إذا تطابقت عناصر النتائج 2000 مع وصف الاستعلام. تتطلب هذه القيمة تحديد علامة GetSinglePage؛ سيتم تجاهله بخلاف ذلك.

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

الإدخالات

System.Uri

System.String

المخرجات

System.Object