Send-ServiceFabricReplicaHealthReport
يرسل تقريرا صحيا على نسخة متماثلة من Service Fabric.
بناء الجملة
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-ReplicaId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-InstanceId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] الوصف
يرسل الأمر cmdlet Send-ServiceFabricReplicaHealthReport تقريرا صحيا على مثيل خدمة بدون حالة Service Fabric أو نسخة متماثلة للخدمة ذات الحالة.
يجب أن يكون مثيل الخدمة عديم الحالة أو النسخة المتماثلة للخدمة ذات الحالة موجودا بالفعل في مخزن الصحة. للتحقق مما إذا كان موجودا، استخدم Get-ServiceFabricReplicaHealth cmdlet، وحدد معلمات PartitionId و ReplicaOrInstanceId . بدلا من ذلك، يمكنك استخدام Get-ServiceFabricPartitionHealth cmdlet مع المعلمة PartitionId ، ثم التحقق من قسم ReplicaHealthStates للعثور على النسخة المتماثلة.
يرسل cmdlet التقرير بعد فاصل زمني محدد بواسطة المعلمة HealthReportSendIntervalInSec ل Connect-ServiceFabricCluster cmdlet. يجب الاحتفاظ باتصال نظام المجموعة على قيد الحياة خلال هذا الوقت.
قد يرجع cmdlet النجاح، ولكن يتم إرسال التقرير بشكل غير متزامن، لذلك قد تفشل معالجته. لمعرفة ما إذا كان التقرير قد تم تطبيقه في مخزن الصحة، استخدم الأمر Cmdlet Get-ServiceFabricReplicaHealth وتحقق من ظهور التقرير في قسم الأحداث الصحية.
قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام Connect-ServiceFabricCluster cmdlet.
أمثلة
مثال 1: تقرير عن حالة الخطأ على نسخة متماثلة للخدمة ذات حالة مع TTL لا نهائي
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"يرسل هذا الأمر تقريرا صحيا للقسم المحدد للنسخة المتماثلة المحددة للخدمة ذات الحالة من المصدر MyWatchDog. يحتوي تقرير الصحة على معلومات حول الخاصية الصحية DiskUsage في حالة صحة الخطأ، مع TTL لا نهائي. يعطي هذا الأمر أيضا وصفا للخطأ.
مثال 2: الإبلاغ عن تقرير حماية التحذير على مثيل خدمة عديم الحالة صالح ل TTL المحدد وإزالته عند انتهاء صلاحيته
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpiredيرسل هذا الأمر تقريرا صحيا لمثيل الخدمة عديم الحالة المحدد من المصدر MyWatchDog. يحتوي تقرير الصحة على معلومات حول موارد الخاصية الصحية في حالة حماية تحذير من المصدر MyWatchdog، مع 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 |
-InstanceId
تحديد معرف مثيل الخدمة عديم الحالة. معرف المثيل صالح فقط للخدمات عديمة الحالة. يتم قبول تقرير لنسخة متماثلة ذات حالة تستخدم InstanceId بدلا من ReplicaId من قبل العميل الصحي، ولكن يتم رفضه من قبل مخزن الصحة.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PartitionId
يحدد معرف قسم Service Fabric.
| Type: | Guid |
| 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 |
-ReplicaId
يحدد معرف النسخة المتماثلة للخدمة ذات الحالة. معرف النسخة المتماثلة صالح فقط للخدمات ذات الحالة. يتم قبول تقرير لمثيل عديم الحالة يستخدم ReplicaId بدلا من InstaceId من قبل العميل الصحي، ولكن يتم رفضه من قبل مخزن الصحة.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| 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.Guid
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