Send-ServiceFabricServiceHealthReport
يرسل تقريرا صحيا على خدمة Service Fabric.
بناء الجملة
Send-ServiceFabricServiceHealthReport
[-ServiceName] <Uri>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
الوصف
يرسل الأمر cmdlet Send-ServiceFabricServiceHealthReport تقريرا صحيا على خدمة Service Fabric.
يجب أن تكون الخدمة موجودة بالفعل في المخزن الصحي. للتحقق مما إذا كان موجودا، استخدم الأمر Cmdlet Get-ServiceFabricServiceHealth وحدد معلمة ServiceName . بدلا من ذلك، يمكنك استخدام Get-ServiceFabricApplicationHealth cmdlet للحصول على معلومات التطبيق ثم التحقق من قسم حالة الخدمة للعثور على الخدمة التي تريدها.
يتم إرسال التقرير بعد عدد الثوان المحددة في المعلمة HealthReportSendIntervalInSec ل Connect-ServiceFabricCluster cmdlet. يجب الاحتفاظ باتصال نظام المجموعة على قيد الحياة خلال هذا الوقت.
قد يرجع cmdlet النجاح، ولكن يتم إرسال التقرير بشكل غير متزامن، لذلك قد تفشل معالجته. لمعرفة ما إذا كان التقرير قد تم تطبيقه في مخزن الصحة، استخدم الأمر Cmdlet Get-ServiceFabricServiceHealth وتحقق من ظهور التقرير في قسم HealthEvents.
قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام Connect-ServiceFabricCluster cmdlet.
أمثلة
مثال 1: تقرير تقرير عن حالة الخطأ مع TTL لانهائي
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error -Description "The service is not available."
يرسل هذا الأمر تقريرا صحيا للخدمة المسماة fabric:/MyApplication/MyService من المصدر MyWatchDog. يحتوي تقرير الصحة على معلومات حول توفر خاصية الصحة في حالة صحة الخطأ، مع TTL لانهائي. يعطي هذا الأمر أيضا وصفا للخطأ.
مثال 2: تحذير التقرير صالح ل TTL المحدد
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "PrivateData" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -Description "Accessing private data in database MyServicePrivateData is slow."
يرسل هذا الأمر تقريرا صحيا على الخدمة المسماة fabric:/MyApplication/MyService من المصدر MyWatchdog. يحتوي تقرير الصحة على معلومات حول الخاصية الصحية PrivateData في حالة حماية تحذير مع TTL لمدة 10 ثوان، ويعلم التقرير لإزالته عند انتهاء الصلاحية.
المعلمات
-Description
تحديد معلومات قابلة للقراءة للإنسان حول الشرط الذي أدى إلى تشغيل التقرير. تصف معلمات SourceId و HealthProperty و HealthState التقرير بشكل كامل.
الحد الأقصى لطول سلسلة الوصف هو 4096 حرفاً. إذا كانت السلسلة المتوفرة أطول، يتم اقتطاعها تلقائيا. عند اقتطاعه، ينتهي الوصف بعلامة، "[اقتطاع]"، للإشارة إلى المستخدمين حدوث اقتطاع. يبلغ إجمالي حجم السلسلة 4096 حرفا، لذلك يتم الاحتفاظ بأقل من 4096 حرفا من السلسلة الأصلية.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthProperty
تحديد خاصية التقرير. جنبا إلى جنب مع معلمة SourceId ، تعرف هذه الخاصية التقرير بشكل فريد.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
يحدد كائن HealthState الذي يمثل الحالة الصحية التي تم الإبلاغ عنها.
Type: | HealthState |
Accepted values: | Invalid, Ok, Warning, Error, Unknown |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Immediate
يحدد ما إذا كان يجب إرسال التقرير إلى المخزن الصحي على الفور. هذا مفيد للتقارير الضرورية التي يجب إرسالها في أقرب وقت ممكن. إذا لم يتم تحديده، يتم إرسال التقرير استنادا إلى إعدادات عميل الحماية. لذلك، سيُنفذ على دفعات وفقا لتكوين HealthReportSendInterval. هذا هو الإعداد الموصى به لأنه يسمح لعميل الصحة بتحسين رسائل تقارير الصحة إلى مخزن الصحة بالإضافة إلى معالجة تقارير الصحة. بشكل افتراضي، يقوم عميل Powershell fabric بتعيين HealthReportSentInterval إلى 0، لذلك يتم إرسال التقارير على الفور.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveWhenExpired
يشير إلى أنه تتم إزالة التقرير من المخزن الصحي عند انتهاء صلاحيته. إذا لم تحدد هذه المعلمة، يتم اعتبار الكيان في حالة الخطأ عند انتهاء صلاحية وقت التقرير للعيش. يمكن استخدام التقارير التي تتم إزالتها عند انتهاء صلاحيتها للشروط الصالحة لفترة زمنية فقط أو لمسح التقارير من Health Store.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SequenceNumber
تحديد رقم التسلسل المقترن بالتقرير الصحي. إذا لم تحدد قيمة لهذه المعلمة، يتم تعيين رقم التسلسل تلقائيا. إذا قمت بتحديد رقم تسلسل، يجب أن تكون هذه القيمة أعلى من أي رقم تسلسل سابق تم تعيينه على نفس SourceId و HealthProperty، أو يتم رفض التقرير بسبب عدم الثبات.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
يحدد معرف المورد الموحد (URI) لخدمة Service Fabric.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
يحدد معرف المصدر الذي قام بتشغيل التقرير.
Type: | String |
Position: | Named |
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 |
-TimeToLiveSec
تحديد مدة البقاء (TTL) للتقرير بالثوان. عند انتهاء صلاحية TTL، تتم إزالة التقرير من مخزن الصحة إذا تم تحديد المعلمة RemoveWhenExpired . وإلا، يتم تقييم الكيان في خطأ بسبب التقرير منتهية الصلاحية. القيمة الافتراضية هي Infinite.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
الإدخالات
System.Uri
System.Fabric.Health.HealthState
System.String
System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Management.Automation.SwitchParameter
System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
المخرجات
System.Object