وصف الخطأ

رسالة الخطأ "The WinRS client cannot process the request. One of the parameters required for the WinrsPush function is null or zero" يحدث عندما تحاول استخدام Windows Remote Shell (WinRS) أو عن بعد PowerShell commands (WS-Management) لتنفيذ العمليات أو دفع كتل الكود إلى جهاز كمبيوتر هدف بعيد.

هذا الاصطدام المحدد داخل الداخلية WinrsPush تعني وظيفة C ++ انهيارًا في البدء أو الاتصالات. وتشير إلى أن آلية جانب العميل المسؤولة عن دفع الحجج أو ملفات البرامج النصية إلى بيئة التنفيذ البعيدة تلقت هيكل بيانات حمولة غير مخصص ، ومسار بيئة غير مُرسَم ، أو حجة أمر فارغة ، أو معايير اتصال فارغة. ويرجع ذلك عادةً إلى تشكيل غير متطابق بين المضيف والجهاز البعيد ، وملفات تعريف WS-Management المحلية (WSMan) الفاسدة ، والحجج المعيارية المفقودة في كتل البرامج النصية ، أو طبقات المصادقة غير المتطابقة بين العميل النشط وبيئة المضيف.

إصلاحات خطوة بخطوة

اتبع هذه التعليمات بالتسلسل لحل نزاعات التكوين الأساسية.

الخطوة 1: تشغيل أداة تكوين WinRM السريعة

غالبًا ما تغفل بنية تحتية إدارة Windows عن بعد غير مثبتة حقول الاتصال الحاسمة ، مما يجبر عمليات الدفع الداخلية على التوقف مع قيمة مؤشر صفر أو صفر.

1. انقر على Start Menu أبحث عن PowerShell ، انقر بزر الماوس الأيمن عليه، واختيار Run as Administrator.
2. اكتب الأمر التالي في نافذة المحطة ثم اضغط Enter:

   winrm quickconfig

3. If the utility flags elements that are not currently running or configured, type Y و اضغط Enter لتحديث القواعد الافتراضية تلقائيًا، وإطلاق المستمعين، وبناء استثناءات قاعدة جدار الحماية الافتراضية.
4. بالإضافة إلى ذلك، تأكد من أن إطار الاتصال البعيد المطلق يتم توفيره بالكامل عن طريق تنفيذ:

   Enable-PSRemoting -Force

الخطوة الثانية: تأكد من المعلمات الصريحة في حمولة الكود الخاصة بك

If this error triggers dynamically inside an automation cycle or complex pipeline utilizing toolsets such as Invoke-Command أو winrs -r:Server command ، غالبا ما تكون علامة على أن المتغيرات الفارغة تفشل في إدخالها إلى واجهات برمجة التطبيقات النظامية الأصلية.

1. Audit the exact syntax of your deployment instruction block. If you are calling a function block that wraps a command or executes script arguments dynamically (such as -ArgumentList ), تأكد من أنك لا تمر أسطوانات فارغة أو مؤشرات مرجعية غير محددة.
2. إذا كانت بنية التنفيذ الخاصة بك تستفيد من صفوف متغيرة (على سبيل المثال، $args[0] ), تنفيذ كتلة اختبار أساسية صارمة لالتقاط القيم الصفرية قبل كتلة النقل:

   if ($null -eq $MyVariable -or $MyVariable -eq 0) {
       Write-Error "Halting deployment: Parameter must not be null or zero."
       exit
   }

الخطوة الثالثة: وضع خرائط واضحة للمستهدف في TrustedHosts

عندما يتم تشغيل نظام المصدر والجهاز المستهدف خارج مجموعة أدلة Active Directory الموحدة أو يجلس عبر مجموعات عمل مختلفة ، يقوم Windows بقطع مصافحة التفويض ، وإرجاع تعريفات الجلسة الفارغة إلى المترجم الضغط.

1. داخل إدارتك المرتفعة PowerShell نافذة، تشغيل هذه السلسلة لرسوم الآلة المستهدفة إلى محيط التحقق من الشبكة الخاصة بك:

   winrm set winrm/config/client @{TrustedHosts="*"}

   (ملاحظة: يمكنك استبدال النجمة العالمية) ` مع عنوان IP محدد أو تسمية المضيف لعقدة الوجهة إذا كان تخطيط أمن شركتك يتطلب حدود صارمة).*

2. التحقق من أن القيمة المسجلة صحيحة عن طريق مسح المعلمات التشخيصية النشطة:

   Get-Item WSMan:\localhost\Client\TrustedHosts

الخطوة الرابعة: تنظيف أو إعادة تعيين معالجات بروكسي WinHTTP المحلية

If your local host routes outward-bound network sequences across structured proxies or localized gateways, the connection payload details can break apart or lose critical properties before reaching the internal WinrsPush طبقة المكونات

1. انقر على Start Menu ، نوع cmd ، انقر بزر الماوس الأيمن على العنصر، واختيار Run as Administrator.
2. قم بتشغيل مسار التشخيص للتحقق من وجود بروكسي منصة ثابت:

   netsh winhttp show proxy

3. إذا تم إخراج سلسلة بروكسي صريحة وتتداخل مع حركة المرور في الشبكة الداخلية، قم بإزالتها عن طريق إزالة كومة مع أمر إعادة تعيين التوجيه:

   netsh winhttp reset proxy

4. أعد تشغيل عمليات معالجة الهدف لضمان التوجيه القياسي

الخطوة الخامسة: إجبار إعادة تعيين ملف اتصال WSMan المحلي

إذا كانت مخططات البيانات الوصفية الأساسية داخل السجل المحلي أو طبقة التكوين تالفة ، فإن إعادة تعيين حدود معايير السجل النشط يعيد التشغيل القياسي.

1. اضغط على Windows Key + R ، نوع regedit, وأضرب Enter لفتح محرر السجل
2. تنقل إلى أسفل إلى مسار شجرة الدليل التالية:

   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WSMAN\

3. قم بنسخ الهيكل عن طريق النقر اليمنى على WSMAN مفتاح المجلد واختيار Export لحفظ ملف لقطة على سطح المكتب الخاص بك.
4. أغلق محرر السجلات افتح إدارة عالية PowerShell استدعاء وتنفيذ هذه السلسلة لتنظيف ذاكرة التخزين المؤقت لحالة خدمة الشبكة وإعادة تحميل إعدادات التشغيل الخاصة بك:

   Restart-Service WinRM -Force