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