Send-ServiceFabricNodeHealthReport
يرسل تقريرا صحيا على عقدة Service Fabric.
بناء الجملة
Send-ServiceFabricNodeHealthReport
[-NodeName] <String>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] الوصف
يرسل الأمر cmdlet Send-ServiceFabricNodeHealthReport تقريرا صحيا على عقدة Service Fabric.
يجب أن تكون العقدة موجودة بالفعل في مخزن الصحة. للتحقق مما إذا كان موجودا، استخدم الأمر Get-ServiceFabricNodeHealth cmdlet. بدلا من ذلك، يمكنك استخدام Get-ServiceFabricNode cmdlet. إذا حصل cmdlet على العقدة وكان للعقدة حالة صحية صالحة، فإن العقدة موجودة في مخزن الصحة.
يرسل cmdlet التقرير بعد فاصل زمني محدد بواسطة المعلمة HealthReportSendIntervalInSec ل Connect-ServiceFabricCluster cmdlet. يجب الاحتفاظ باتصال نظام المجموعة على قيد الحياة خلال هذا الوقت. يتم تقييم الأمر على العميل دون الرجوع إلى التشغيل على المخزن الصحي. قد لا يتم تطبيق التقرير في مخزن الحماية حتى إذا كان الأمر يرجع النجاح. على سبيل المثال، قد يرفض مخزن الحماية التقرير بسبب معلمة غير سليمة، مثل رقم التسلسل القديم.
لمعرفة ما إذا كان التقرير قد تم تطبيقه في مخزن الصحة، استخدم الأمر Cmdlet Get-ServiceFabricNodeHealth وتحقق من ظهور التقرير في قسم HealthEvents.
لإدارة مجموعات Service Fabric، ابدأ Windows PowerShell باستخدام الخيار Run as administrator. قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام الأمر Cmdlet Connect-ServiceFabricCluster ثم Get-ServiceFabricClusterConnection cmdlet.
أمثلة
مثال 1: تقرير تقرير عن حالة الخطأ مع TTL لانهائي
PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "Firewall" -HealthState Error -Description "Firewall rules were not correctly applied"يرسل هذا الأمر تقريرا صحيا على العقدة المسماة Node01 من المصدر المسمى MyWatchdog. يحتوي تقرير الصحة على معلومات حول جدار حماية الخاصية الصحية في حالة صحة الخطأ، مع TTL لانهائي.
مثال 2: تحذير التقرير صالح ل TTL المحدد
PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "CPU" -HealthState Warning -Description "CPU has been more than 90% for the last hour." -TimeToLiveSec 10 -RemoveWhenExpiredيرسل هذا الأمر تقريرا صحيا على العقدة المسماة Node01 من المصدر المسمى MyWatchdog. يحتوي تقرير الصحة على معلومات حول الخاصية الصحية CPU في حالة حماية التحذير. يعطي الأمر أيضا وصفا للتحذير، ويعين 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 ، تعرف هذه الخاصية التقرير بشكل فريد. يتجاوز التقرير أي تقارير سابقة بنفس القيم لمعلمات SourceId و HealthProperty على نفس الكيان.
| 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 |
-NodeName
تحديد اسم عقدة Service Fabric. يرسل cmdlet تقريرا صحيا على العقدة التي تحددها.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
-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.String
System.Fabric.Health.HealthState
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