Get-ServiceFabricDeployedApplication
يحصل على تطبيق (تطبيقات) Service Fabric على عقدة محددة.
بناء الجملة
Get-ServiceFabricDeployedApplication
[-NodeName] <String>
[[-ApplicationName] <Uri>]
[-UsePaging]
[-GetSinglePage]
[-IncludeHealthState]
[-MaxResults <Int64>]
[-ContinuationToken <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Get-ServiceFabricDeployedApplication
[-NodeName] <String>
[[-ApplicationName] <Uri>]
[-TimeoutSec <Int32>]
[<CommonParameters>] الوصف
يحصل الأمر cmdlet Get-ServiceFabricDeployedApplication على تطبيق (تطبيقات) Service Fabric التي تم نشرها على عقدة محددة.
ينشئ Service Fabric أدلة عمل وسجل ودلائل مؤقتة على العقدة لكل تطبيق تم نشره. نظرا لأن أسماء الدليل تتضمن معرف التطبيق، لا يمكن تخمين أسماء الدليل. عندما يكون DeployedApplicationStatus نشطا، يقوم Get-ServiceFabricDeployedApplication بإرجاع أسماء الدليل في قيم إرجاع WorkDirectoryوLogDirectory و TempDirectory . عندما يتم تنزيل DeployedApplicationStatus ، تكون قيم WorkDirectoryوLogDirectory و TempDirectory خالية.
تخزن خدمات التطبيقات المنشورة بياناتها المستمرة في WorkDirectory. لأغراض تصحيح الأخطاء أو التشخيص، قد يحتاج تطبيق أو عملية مختلفة إلى معرفة موقع WorkDirectory.
يجب أن تخزن خدمات التطبيق المنشورة سجلها في LogDirectory الذي تم إنشاؤه بواسطة Service Fabric. قد يحتاج المحمل المخصص لملفات السجل إلى معرفة الموقع. قد يكون موقع LogDirectory مطلوبا لأغراض التشخيص أيضا عندما لا يعمل تطبيق على عقدة معينة كما هو متوقع.
بشكل افتراضي، يقوم هذا الاستعلام بإرجاع عدد من النتائج محدودة بتكوين الحد الأقصى لحجم الرسالة. تدعم SDKs وإصدارات المجموعات 6.1 أو الإصدارات الأحدث وظيفة الترحيل التي تزيل هذا التقييد؛ سيكون السلوك الجديد هو إرجاع النتائج بغض النظر عن الحد الأقصى لتكوين حجم الرسالة لأن هذا الاستعلام يتكرر عبر جميع الصفحات التي تم إرجاعها بشفافية. لاستخدام الترحيل والوظائف الجديدة الأخرى، راجع مجموعة المعلمات "UsePagedAPI". يؤدي تحديد أي عوامل تصفية جديدة إلى الإشارة إلى الاستعلام لاستخدام الترحيل تحت الغطاء. وإلا، حدد "UsePaging" للاشتراك في الاستعلام المقسم إلى صفحات.
قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام Connect-ServiceFabricCluster cmdlet.
أمثلة
مثال 1: الحصول على التطبيق "fabric:/samples/CalcApp2"
PS C:\> Get-ServiceFabricDeployedApplication -NodeName "VIPULM4-RK01-BD01" -ApplicationName fabric:/samples/CalcApp2
ApplicationName : fabric:/samples/CalcApp2
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\work
LogDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\log
TempDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\temp
HealthState : Unknownيقوم هذا الأمر بإرجاع التطبيقات المنشورة. في هذا المثال، DeployedApplicationStatus نشط، وبالتالي، يقوم Get-ServiceFabricDeployedApplication بإرجاع أسماء الدليل في قيم WorkDirectoryوLogDirectory و TempDirectory .
مثال 2: الحصول على التطبيق "fabric:/samples/VQueueApp2"
PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2
ApplicationName : fabric:/samples/VQueueApp2
ApplicationTypeName : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState : Unknownيقوم هذا الأمر بإرجاع التطبيقات المنشورة. في هذا المثال، يتم تنزيل DeployedApplicationStatus ، وبالتالي، يقوم الأمر بإرجاع قيم فارغة ل WorkDirectoryوLogDirectory و TempDirectory.
مثال 3: الحصول على التطبيق (التطبيقات) مع أقصى النتائج
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -MaxResults 2 -GetSinglePage -Verbose
ApplicationName : fabric:/samples/CalculatorApp
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState : Unknown
ApplicationName : fabric:/samples/PQueueApp1
ApplicationTypeName : PersistentQueueApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\temp
HealthState : Unknown
VERBOSE: Continuation Token: fabric:/samples/PQueueApp1يحصل هذا الأمر على جميع تطبيقات (تطبيقات) Service Fabric المنشورة على العقدة المتوفرة في نظام المجموعة التي تناسب الصفحة. يقتصر حجم الصفحة أيضا على عنصرين، كما تم تكوينه بواسطة المعلمة MaxResults. نظرا لأننا حددنا الخيار "GetSinglePage"، فسيرجع هذا الاستعلام صفحة واحدة فقط من النتائج. لا يمكن استخدام MaxResults بدون هذا الخيار. يؤدي تحديد "مطول" إلى طباعة قيمة الرمز المميز للمتابعة التي تم إرجاعها. يمكن استخدام هذه القيمة في استعلام لاحق للحصول على الصفحة التالية من النتائج. يمكنك أيضا الوصول إلى رمز المتابعة الذي تم إرجاعه عن طريق حفظ النتائج التي تم إرجاعها والوصول إلى الخاصية "ContinuationToken". الخاصية "ContinuationToken" فارغة لا يوجد أي رمز مميز للمتابعة تم إرجاعه.
مثال 4: الحصول على التطبيق مع رمز المتابعة المميز
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ContinuationToken fabric:/samples/PQueueApp1 -UsePaging
ApplicationName : fabric:/samples/VQueueApp1
ApplicationTypeName : VolatileQueueApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\temp
HealthState : Unknownيحصل هذا الأمر على تطبيق (تطبيقات) Service Fabric الذي يحترم رمز المتابعة الذي تم توفيره والذي يتناسب مع صفحة واحدة. رمز المتابعة الذي تم توفيره لهذا الاستعلام هو نفس الرمز الذي تم إرجاعه من المثال أعلاه. في نظام مجموعة المثال هذا، يوجد عنصر واحد فقط يحترم رمز المتابعة المميز. إذا كان هناك عدد كبير جدا من التطبيقات التي تحترم رمز المتابعة المقدم على العقدة لتلائم صفحة واحدة من النتائج، فسيرجع تكوين الاستعلام هذا تجميعا لجميع الصفحات التي تم إرجاعها، ويتكرر من خلالها بشفافية؛ سيقوم الاستعلام بعد ذلك بإرجاع متجه لكافة النتائج. للحصول على صفحة واحدة فقط من النتائج، حدد الخيار "GetSinglePage".
مثال 5: الحصول على تطبيق بحالة صحية
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ApplicationName fabric:/samples/CalculatorApp -IncludeHealthState
ApplicationName : fabric:/samples/CalculatorApp
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState : Okيحصل هذا الأمر على تطبيق Service Fabric الذي يطابق اسم التطبيق المقدم ويتضمن حالته الصحية.
المعلمات
-ApplicationName
يحدد معرف المورد الموحد (URI) لتطبيق Service Fabric. يحصل cmdlet على التطبيق المنشور الذي يطابق اسم التطبيق المحدد. يقوم هذا الاستعلام بمطابقة تامة. على سبيل المثال، لن يتطابق نسيج URI:/App مع النسيج:/App1. سيتم إرجاع نتيجة واحدة على الأكثر إذا تم توفير اسم التطبيق. إذا لم يتطابق اسم التطبيق المتوفر مع أي تطبيق على العقدة، يرجع الاستعلام قيمة خالية.
| Type: | Uri |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ContinuationToken
يحدد رمز المتابعة الذي يمكن استخدامه لاسترداد الصفحة التالية من نتائج الاستعلام.
إذا كان عدد كبير جدا من النتائج يحترم عوامل التصفية المتوفرة، فقد لا يتم احتواؤها في رسالة واحدة. يتم استخدام الترحيل لحساب هذا عن طريق تقسيم مجموعة النتائج التي تم إرجاعها إلى صفحات منفصلة. يتم استخدام الرمز المميز للمتابعة لمعرفة من أين توقفت الصفحة السابقة، مع حمل significance فقط للاستعلام نفسه. يجب إنشاء هذه القيمة من تشغيل هذا الاستعلام، ويمكن تمريرها إلى طلب الاستعلام التالي للحصول على الصفحات اللاحقة. يتم إرجاع قيمة الرمز المميز للمتابعة غير الفارغة كجزء من النتيجة فقط إذا كانت هناك صفحة لاحقة. إذا تم توفير هذه القيمة بدون الخيار -GetSinglePage، فسيرجع الاستعلام كافة الصفحات بدءا من قيمة الرمز المميز للمتابعة.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GetSinglePage
تحديد ما إذا كان الاستعلام سيرجع صفحة واحدة من نتائج الاستعلام بقيمة رمز مميز للمتابعة، أو كافة الصفحات المدمجة في قائمة واحدة من النتائج. إذا تم تحديد هذا الخيار، فستكون مسؤولية المتصل بالاستعلام هي التحقق من الصفحات اللاحقة.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeHealthState
يحدد ما إذا كان الاستعلام سيعيد الحالة الصحية للتطبيقات المنشورة. إذا لم يتم تحديد هذه المعلمة، فإن الحالة الصحية التي تم إرجاعها هي "غير معروف". عند تحديده، ينتقل الاستعلام بالتوازي مع العقدة وخدمة النظام الصحي قبل دمج النتائج. ونتيجة لذلك، يكون الاستعلام أكثر تكلفة وقد يستغرق وقتًا أطول.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-NodeName
يحدد اسم عقدة Service Fabric. يحصل cmdlet على التطبيقات المنشورة على العقدة التي تحددها.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeoutSec
تحديد فترة المهلة، بالثوان، للعملية.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsePaging
تحديد ما إذا كان سيتم صفحة الاستعلام أم لا. إذا لم يتم تحديده، فلن يعمل هذا الاستعلام عندما يكون هناك عدد كبير جدا من النتائج التي لا يمكن احتواؤها على صفحة واحدة، كما هو محدد بواسطة تكوين حجم الرسالة الأقصى. يؤدي تحديد هذا الخيار إلى تكوين هذا الاستعلام لإرجاع جميع النتائج، بغض النظر عن تكوين الحد الأقصى لحجم الرسالة. يقوم بذلك عن طريق الحصول على نتائج مصفحة، والتكرار الحلقي عبر جميع الصفحات بشفافية نيابة عن المتصل.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
الإدخالات
System.String
System.Uri
المخرجات
System.Object