Send-ServiceFabricDeployedServicePackageHealthReport
يرسل تقريرا صحيا على حزمة الخدمة المنشورة في Service Fabric.
بناء الجملة
Send-ServiceFabricDeployedServicePackageHealthReport
[-ApplicationName] <Uri>
[-ServiceManifestName] <String>
[-NodeName] <String>
[[-ServicePackageActivationId] <String>]
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] الوصف
يرسل الأمر cmdlet Send-ServiceFabricDeployedServicePackageHealthReport تقريرا صحيا على حزمة الخدمة المنشورة في Service Fabric.
يجب أن تكون حزمة الخدمة المنشورة موجودة بالفعل في مخزن الحماية. للتحقق مما إذا كانت الخدمة موجودة، استخدم الأمر Get-ServiceFabricDeployedServicePackageHealth cmdlet. حدد اسم التطبيق واسم حزمة الخدمة واسم العقدة. بدلا من ذلك، يمكنك استخدام Get-ServiceFabricDeployedApplicationHealth cmdlet. حدد اسم التطبيق واسم العقدة، وتحقق من قسم الحالات الصحية لحزمة الخدمة المنشورة للعثور على حزمة الخدمة.
يرسل cmdlet التقرير بعد فاصل زمني محدد بواسطة المعلمة HealthReportSendIntervalInSec ل Connect-ServiceFabricCluster cmdlet. يجب الاحتفاظ باتصال نظام المجموعة على قيد الحياة خلال هذا الوقت. يتم تقييم الأمر على العميل دون الرجوع إلى التشغيل على المخزن الصحي. قد لا يتم تطبيق التقرير في مخزن الحماية حتى إذا كان الأمر يرجع النجاح. على سبيل المثال، قد يرفض مخزن الحماية التقرير بسبب معلمة غير سليمة، مثل رقم التسلسل القديم.
لمعرفة ما إذا كان التقرير قد تم تطبيقه في مخزن الصحة، استخدم الأمر Cmdlet Get-ServiceFabricDeployedServicePackageHealth وتحقق من ظهور التقرير في قسم HealthEvents .
لإدارة مجموعات Service Fabric، ابدأ Windows PowerShell باستخدام الخيار Run as administrator. قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام الأمر Cmdlet Connect-ServiceFabricCluster ثم Get-ServiceFabricClusterConnection cmdlet.
أمثلة
مثال 1: تقرير تقرير عن حالة الخطأ مع TTL لانهائي
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"يرسل هذا الأمر تقريرا صحيا على حزمة خدمة منشورة للتطبيق المسمى fabric:/MyApplication على العقدة المسماة Node01 لبيان الخدمة المسمى MyServiceManifest. يحتوي تقرير الصحة على معلومات حول خاصية الصحة الذاكرة في حالة صحة الخطأ من المصدر MyWatchdog، مع TTL لانهائي. لا يتم إعطاء الوصف ويتم تعيين رقم التسلسل تلقائيا.
مثال 2: تحذير التقرير صالح ل TTL محدد وإزالته عند انتهاء صلاحيته
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -ServiceManifestName MyServiceManifest -NodeName "Node01" -HealthProperty "CustomSetup" -HealthState Warning -SourceId MyWatchdog -RemoveWhenExpired -Description "The setup has completed with some warnings." -TimeToLiveSec 10يرسل هذا الأمر تقريرا صحيا على حزمة خدمة منشورة للتطبيق المسمى fabric:/MyApplication لبيان الخدمة المسمى MyServiceManifest على العقدة المسماة Node01. يحتوي تقرير الصحة على معلومات حول خاصية الحماية CustomSetup في حالة حماية تحذير من المصدر MyWatchdog، مع TTL 10 ثوان. بعد انتهاء صلاحية التقرير، تتم إزالته من المخزن الصحي ولن يؤثر بعد ذلك على تقييم الصحة. يقدم هذا الأمر أيضا وصفا للتحذير.
المعلمات
-ApplicationName
يحدد معرف المورد الموحد (URI) لتطبيق Service Fabric. يرسل cmdlet تقريرا صحيا للتطبيق الذي يحتوي على URI الذي تحدده.
| النوع: | Uri |
| Position: | 0 |
| القيمة الافتراضية: | None |
| مطلوب: | True |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-Description
تحديد معلومات قابلة للقراءة للإنسان حول الشرط الذي أدى إلى تشغيل التقرير. تصف معلمات SourceId و HealthProperty و HealthState التقرير بشكل كامل.
الحد الأقصى لطول سلسلة الوصف هو 4096 حرفاً. إذا كانت السلسلة المتوفرة أطول، يتم اقتطاعها تلقائيا. عند اقتطاعه، ينتهي الوصف بعلامة، "[اقتطاع]"، للإشارة إلى المستخدمين حدوث اقتطاع. يبلغ إجمالي حجم السلسلة 4096 حرفا، لذلك يتم الاحتفاظ بأقل من 4096 حرفا من السلسلة الأصلية.
| النوع: | String |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-HealthProperty
تحديد خاصية التقرير. جنبا إلى جنب مع معلمة SourceId ، تعرف هذه الخاصية التقرير بشكل فريد. يتجاوز التقرير أي تقارير سابقة بنفس القيم لمعلمات SourceId و HealthProperty على نفس الكيان.
| النوع: | String |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | True |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-HealthState
يحدد كائن HealthState الذي يمثل الحالة الصحية التي تم الإبلاغ عنها.
| النوع: | HealthState |
| القيم المقبولة: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | True |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-Immediate
يحدد ما إذا كان يجب إرسال التقرير إلى المخزن الصحي على الفور. هذا مفيد للتقارير الضرورية التي يجب إرسالها في أقرب وقت ممكن. إذا لم يتم تحديده، يتم إرسال التقرير استنادا إلى إعدادات عميل الحماية. لذلك، سيُنفذ على دفعات وفقا لتكوين HealthReportSendInterval. هذا هو الإعداد الموصى به لأنه يسمح لعميل الصحة بتحسين رسائل تقارير الصحة إلى مخزن الصحة بالإضافة إلى معالجة تقارير الصحة. بشكل افتراضي، يقوم عميل Powershell fabric بتعيين HealthReportSentInterval إلى 0، لذلك يتم إرسال التقارير على الفور.
| النوع: | SwitchParameter |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
| قبول أحرف البدل: | False |
-NodeName
تحديد اسم عقدة Service Fabric. يرسل cmdlet تقريرا صحيا لحزمة خدمة تم نشرها على العقدة التي تحددها.
| النوع: | String |
| Position: | 2 |
| القيمة الافتراضية: | None |
| مطلوب: | True |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-RemoveWhenExpired
يشير إلى أنه تتم إزالة التقرير من المخزن الصحي عند انتهاء صلاحيته. إذا لم تحدد هذه المعلمة، يتم اعتبار الكيان في حالة الخطأ عند انتهاء صلاحية وقت التقرير للعيش. يمكن استخدام التقارير التي تتم إزالتها عند انتهاء صلاحيتها للشروط الصالحة لفترة زمنية فقط أو لمسح التقارير من Health Store.
| النوع: | SwitchParameter |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-SequenceNumber
تحديد رقم التسلسل المقترن بالتقرير الصحي. إذا لم تحدد قيمة لهذه المعلمة، يتم تعيين رقم التسلسل تلقائيا. إذا قمت بتحديد رقم تسلسل، يجب أن تكون هذه القيمة أعلى من أي رقم تسلسل سابق تم تعيينه على نفس SourceId و HealthProperty، أو يتم رفض التقرير بسبب عدم الثبات.
| النوع: | Int64 |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-ServiceManifestName
تحديد اسم بيان خدمة Service Fabric. جنبا إلى جنب مع ApplicationNameوNodeName، تحدد هذه القيمة بشكل فريد الكيان الصحي لحزمة الخدمة المنشورة.
| النوع: | String |
| Position: | 1 |
| القيمة الافتراضية: | None |
| مطلوب: | True |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-ServicePackageActivationId
معرف التنشيط ل ServicePackage المنشور. يمكن الحصول على هذا باستخدام الاستعلام Get-ServiceFabricDeployedServicePackage.
إذا كانت ServicePackageActivationMode المحددة في وقت إنشاء الخدمة (باستخدام New-ServiceFabricService) هي SharedProcess (أو إذا لم يتم تحديدها، وفي هذه الحالة يتم تعيينها افتراضيا إلى SharedProcess)، فإن قيمة ServicePackageActivationId هي دائما سلسلة فارغة ولا تحتاج إلى تحديد. لمعرفة المزيد حول معرف تنشيط حزمة الخدمة، يرجى مراجعة [Service Fabric Hosting Model][1].
| النوع: | String |
| Position: | 3 |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-SourceId
يحدد معرف المصدر الذي قام بتشغيل التقرير.
| النوع: | String |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | True |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-TimeoutSec
تحديد فترة المهلة، بالثوان، للعملية.
| النوع: | Int32 |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
| قبول أحرف البدل: | False |
-TimeToLiveSec
تحديد مدة البقاء (TTL) للتقرير بالثوان. عند انتهاء صلاحية TTL، تتم إزالة التقرير من مخزن الصحة إذا تم تحديد المعلمة RemoveWhenExpired . وإلا، يتم تقييم الكيان في خطأ بسبب التقرير منتهية الصلاحية. القيمة الافتراضية هي Infinite.
| النوع: | Int32 |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
الإدخالات
System.Uri
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