> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# PowerShell للمسؤولين: الكائنات Objects بدل النص
- URL: https://arabroot.io/articles/powershell-للمسؤولين-الكائنات-بدل-النص/
- Published: 2026-11-12T06:54:04.000Z
- Updated: 2026-11-16T11:46:46.000Z
- Description: لماذا ينكسر السكربت الذي يقص مخرج الأوامر في Windows، وكيف تبني بكائنات PowerShell تقريراً صباحياً عن الأقراص والخدمات والأخطاء يعمل في 5.1 و7 دون صلاحيات المدير.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, Windows للمسؤولين والمطورين

لنفرض أنك مسؤول الأنظمة في شركة ناشئة فيها ثلاثون جهاز Windows وسيرفران، وطلب منك المدير أن يصله كل صباح تقرير قصير يقول له أي جهاز امتلأ قرصه، وأي خدمة Service كان يفترض أن تعمل وتوقفت، وما الأخطاء التي سجلها النظام في الليلة الماضية. وأول ما يخطر لك أن تفتح موجه الأوامر cmd وتكتب الأوامر التي تعرفها منذ سنوات، `tasklist` و`wmic` و`sc`، ثم تقص ما تطبعه بسكربت صغير وتجمعه في ملف. ولكنك سوف تكتشف بسرعة أن `wmic` نفسه لم يعد موجوداً في الأجهزة الجديدة، وأن السكربت الذي يقص النص ينكسر عند أول اسم فيه مسافة أو أول رقم فيه فاصلة، وأنك تقضي وقتك في تخمين أين يبدأ العمود وأين ينتهي بدل أن تقضيه في المشكلة نفسها.

وهذه بالضبط المشكلة التي صمم من أجلها PowerShell: في Linux تتكلم الأدوات مع بعضها بالنص، وهذا يعمل جيداً هناك لأن كل شيء في النظام ملف نصي تقريباً، أما في Windows فالإعدادات والخدمات والسجلات تعيش خلف واجهات برمجية API، والنص الذي تطبعه الأدوات مجرد رسم للشاشة. لذلك قرر PowerShell أن يمرر بين الأوامر كائنات Objects كاملة، لكل منها خصائص بأسماء وأنواع، بدل أسطر نص يقصها كل أمر بطريقته. وفي هذا المقال سوف نبني التقرير الذي طلبه المدير خطوة خطوة على جهاز Windows 11 حقيقي ودون صلاحيات المدير Administrator، ونرى عند كل خطوة لماذا يختلف التفكير بالكائنات عن التفكير بالنص.

وسوف نناقش في هذا المقال ما يلي:

- لماذا لا يكفي النص في Windows، وكيف بدأ PowerShell.
- تجهيز المختبر، ونسختا PowerShell على الجهاز نفسه، وسياسة التشغيل Execution Policy.
- الطريقة القديمة: قص مخرج `tasklist`، وثلاث محاولات تفشل كل منها بطريقة مختلفة.
- الكائن: ماذا يرجع `Get-Process` فعلاً، وكيف تكتشف خصائصه بـ `Get-Member`.
- الأنبوب Pipeline مع `Where-Object` و`Select-Object` و`Sort-Object` و`Group-Object`، على خدمات الجهاز.
- لماذا يوضع `Format-Table` في آخر الأنبوب فقط.
- التصدير إلى CSV وJSON، والفروق بين Windows PowerShell 5.1 وPowerShell 7 التي ستقابلها.
- سكربت التقرير الصباحي كاملاً، وما وجده في جهاز المختبر.
- الأخطاء الشائعة، وتدريب عملي.

## لماذا لا يكفي النص في Windows؟

إذا كنت قد عملت على Linux فأنت تعرف الطريقة المعتادة هناك، والتي شرحناها في [مقال سطر الأوامر في Linux](https://arabroot.io/articles/%D8%B3%D8%B7%D8%B1-%D8%A7%D9%84%D8%A7%D9%88%D8%A7%D9%85%D8%B1-%D9%81%D9%8A-linux-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/): أمر يطبع أسطراً، والأنبوب يمرر هذه الأسطر إلى أمر آخر مثل `grep` أو `awk` فيقصها ويختار منها. وهذه الطريقة ناجحة في Linux لأن النظام نفسه مبني على النص، فإعدادات الخدمات ملفات نصية في `/etc`، والسجلات ملفات نصية، وحتى معلومات العمليات تقرؤها من ملفات في `/proc`. أما Windows فمبني بطريقة مختلفة تماماً، فالإعدادات في السجل Registry، والخدمات يديرها مدير الخدمات Service Control Manager، والسجلات Event Logs قاعدة بيانات ثنائية، والمعلومات عن العتاد والنظام تأتي من WMI، وكل هذه تصل إليها من خلال واجهات برمجية لا من خلال ملفات. وبالتالي عندما يطبع أمر مثل `tasklist` جدولاً، فهذا الجدول صنعه الأمر لعينك أنت، وليس الشكل الحقيقي للبيانات، وأي سكربت يقصه يعتمد على عرض الأعمدة وترتيبها وطريقة كتابة الأرقام فيها.

وقد كتب Jeffrey Snover، المهندس الذي بدأ المشروع في Microsoft، وثيقة اسمها Monad Manifesto وصف فيها هذه الرؤية، ونشرها فريق PowerShell كاملة في [مدونته في مارس 2007](https://devblogs.microsoft.com/powershell/monad-manifesto-the-origin-of-windows-powershell/?ref=arabroot.io) وقال إنها الوثيقة التي بدأ منها العمل على ما أصبح لاحقاً PowerShell. والفكرة الأساسية فيها بسيطة: إذا كانت الأوامر كلها تعمل فوق .NET، فلماذا يحول الأمر الأول الكائن إلى نص ثم يعيد الأمر الثاني بناءه من النص؟ دع الكائن نفسه يمر في الأنبوب، ولا يتحول إلى نص إلا في النهاية عندما يعرض على الشاشة.

![رجل بقميص أبيض وربطة عنق ملونة يجلس على منصة في مؤتمر وأمامه قنينة ماء وخلفه ستارة حمراء داكنة](https://arabroot.io/content/images/2026/11/powershell-basics-06-jeffrey-snover.webp)

Jeffrey Snover في مؤتمر المطورين PDC عام 2009\. الصورة: Microsoft PDC، رخصة CC BY 2.0، المصدر: [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Professional%5FDevelopers%5FConference%5F2009%5FTechnical%5FLeaders%5FPanel%5F1%5F%28Jeffrey%5FSnover%29.jpg?ref=arabroot.io) (تم تحويلها إلى WebP).

وصدر Windows PowerShell 1.0 في نوفمبر 2006، ثم أصبح الإصدار 2.0 جزءاً من Windows 7 في 2009، وآخر إصدار من هذا الفرع هو Windows PowerShell 5.1 الذي صدر في أغسطس 2016 مع Windows 10، وما زال موجوداً في كل جهاز Windows حتى اليوم، كما تقول [صفحة دورة دعم PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/powershell-support-lifecycle?ref=arabroot.io). وفي الشهر نفسه، أغسطس 2016، [أعلنت Microsoft](https://azure.microsoft.com/en-us/blog/powershell-is-open-sourced-and-is-available-on-linux/?ref=arabroot.io) أن PowerShell أصبح مفتوح المصدر ويعمل على Linux، وبدأ فرع جديد اسمه PowerShell فقط، بدون كلمة Windows، مبني على .NET Core بدل .NET Framework، ووصل اليوم إلى PowerShell 7.6 وهو إصدار الدعم الطويل LTS الحالي. وهذا هو سبب أن في جهازك اليوم غالباً نسختين بأسماء متشابهة وسلوك مختلف في تفاصيل مهمة، وسوف نرى هذه التفاصيل في المختبر واحدة واحدة بدل أن نسردها نظرياً.

## تجهيز المختبر Lab

المختبر مجموعة سكربتات صغيرة في مجلد `lab`، كل سكربت يجيب عن سؤال واحد ويطبع مخرجه في أقسام مرقمة، والسكربت `run.ps1` يشغلها كلها بالترتيب ويحفظ مخرج كل واحد في ملف. وكل السكربتات تعمل في Windows PowerShell 5.1 الموجود في الجهاز، دون صلاحيات المدير، وسكربتان منها (التصدير والترميز) نشغلهما مرة ثانية في PowerShell 7.6 داخل Container من Docker Image الرسمية لـ .NET 10 SDK، والتي [تقول Microsoft](https://learn.microsoft.com/en-us/powershell/scripting/install/powershell-support-lifecycle?ref=arabroot.io) إنها تحتوي آخر إصدار من PowerShell. والسبب أننا نريد أن نرى الفرق بين النسختين على البيانات نفسها، دون أن نثبت PowerShell 7 في الجهاز، وإذا كان لديك PowerShell 7 مثبتاً فيمكنك أن تشغل السكربتين بـ `pwsh` مباشرة.

```powershell
# run.ps1: runs the whole lab. Start it from Windows PowerShell 5.1 in this folder, no admin needed:
#   powershell -NoProfile -ExecutionPolicy Bypass -File .\run.ps1
# Scripts 04 and 07 run a second time in PowerShell 7.6 inside Docker (the .NET 10 SDK Image ships pwsh).
$ErrorActionPreference = 'Continue'
Set-Location $PSScriptRoot
$pwsh7 = 'mcr.microsoft.com/dotnet/sdk:10.0'
function Save($name, $text) {
    $clean = (($text -join "`n") -replace "`r", '' -replace "\x1b\[[0-9;]*m", '' -replace "\n{3,}", "`n`n" -replace "(### [^\n]+)\n\n", "`$1`n").Trim() + "`n"
    [System.IO.File]::WriteAllText((Join-Path $PSScriptRoot $name), $clean, [System.Text.UTF8Encoding]::new($false))
    Write-Host "wrote $name"
}
function Run5($script, $arguments = @()) { & powershell.exe -NoProfile -ExecutionPolicy Bypass -File $script @arguments 2>&1 | Out-String -Width 160 }
function Run7($script) { & docker run --rm -v "${PSScriptRoot}:/lab" -w /lab $pwsh7 pwsh -NoProfile -File "/lab/$script" 2>&1 | Out-String -Width 160 }

Remove-Item -Recurse -Force out-5, out-7, reports, reports-depth2 -ErrorAction SilentlyContinue
Save 'out-00-versions.txt'  @((Run5 '00-versions.ps1'), (Run7 '00-versions.ps1'))
Save 'out-01-text.txt'      (Run5 '01-text.ps1')
Save 'out-02-objects.txt'   (Run5 '02-objects.ps1')
Save 'out-03-pipeline.txt'  (Run5 '03-pipeline.ps1')
Save 'out-04-export-5.txt'  (Run5 '04-export.ps1')
Save 'out-04-export-7.txt'  (Run7 '04-export.ps1')
Save 'out-05-format.txt'    (Run5 '05-format-trap.ps1')
Save 'out-06-report.txt'    (Run5 '06-report.ps1' @('-Label', 'PC-01'))
Save 'out-06-files.txt'     @('### 1. reports/issues.csv', (Get-Content reports/issues.csv -Encoding UTF8 | Out-String),
                              '### 2. reports/report.json', (Get-Content reports/report.json -Encoding UTF8 | Out-String))
Save 'out-07-bom.txt'       @((Run5 '07-bom.ps1'), (Run7 '07-bom.ps1'))
```

ولتشغيل المختبر افتح Windows PowerShell في مجلد `lab` واكتب:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\run.ps1
```

وأول سكربت يطبع أي PowerShell يعمل، وعلى أي .NET، وهل الجلسة بصلاحيات المدير، والمخرج سوف يكون كما يلي:

```text
### 1. Version
PowerShell  : 5.1.26100.9711 (Desktop)
Executable  : powershell.exe
Runtime     : .NET Framework 4.8.9363.0
OS          : Microsoft Windows 11 Pro build 26100
Admin       : False
Policy      : Bypass (LocalMachine: RemoteSigned)

### 1. Version
PowerShell  : 7.6.10 (Core)
Executable  : pwsh
Runtime     : .NET 10.0.15
OS          : Ubuntu 24.04.5 LTS
```

في المخرج أعلاه لاحظ التالي:

- القسم الأول هو Windows PowerShell 5.1، واسم البرنامج `powershell.exe`، ويعمل على .NET Framework 4.8 الموجود في Windows، والإصدار Desktop.
- القسم الثاني هو PowerShell 7.6.10، واسم البرنامج `pwsh`، ويعمل على .NET 10، والإصدار Core. وتغيير اسم البرنامج كان مقصوداً كما [تشرح Microsoft](https://learn.microsoft.com/en-us/powershell/scripting/whats-new/differences-from-windows-powershell?ref=arabroot.io)، حتى تثبت النسختين جنباً إلى جنب ويعرف كل سكربت أيهما يستدعي.
- السطر `Admin : False` يعني أن كل ما في هذا المقال يعمل بحساب مستخدم عادي، وهذه نقطة مهمة لأن التقرير اليومي لا يحتاج صلاحيات المدير ولا ينبغي أن يأخذها.
- السطر الأخير في القسم الأول يبين سياسة التشغيل، وهي موضوع الفقرة التالية.

### سياسة التشغيل Execution Policy

أول مرة تحاول فيها تشغيل ملف `.ps1` على جهاز Windows جديد قد ترى رسالة تقول إن تشغيل السكربتات معطل في هذا النظام. والسبب أن [سياسة التشغيل Execution Policy](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about%5Fexecution%5Fpolicies?ref=arabroot.io) إذا لم يضبطها أحد في أي نطاق تكون Restricted في أجهزة المستخدمين، أي أن الأوامر تعمل في الطرفية ولكن ملفات السكربت لا تعمل، بينما تكون RemoteSigned في Windows Server، أي أن السكربت الذي كتبته في الجهاز يعمل، والسكربت الذي جاء من الإنترنت لا يعمل إلا إذا كان موقعاً. وفي جهاز المختبر كانت السياسة على مستوى الجهاز LocalMachine هي RemoteSigned، ولكننا شغلنا السكربتات بـ `-ExecutionPolicy Bypass`، وهذا الخيار يغير السياسة للجلسة التي يفتحها فقط، ولا يحفظ شيئاً في إعدادات الجهاز.

وقد يتساءل البعض: هل هذا يعني أن Bypass ثغرة أمنية؟ والإجابة أن Microsoft نفسها تقول في الصفحة نفسها إن سياسة التشغيل ليست حداً أمنياً Security Boundary، وإنما حماية إضافية تمنعك من تشغيل سكربت بالخطأ، لأن أي مستخدم يستطيع أن ينسخ محتوى السكربت ويلصقه في الطرفية. لذلك لا تعتمد عليها لمنع أحد من شيء، واعتمد على الصلاحيات نفسها، وإذا أردت أن يعمل سكربت التقرير كل يوم فاضبط السياسة للمستخدم الذي يشغله فقط بـ `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` بدل أن تفتحها للجهاز كله.

## الطريقة القديمة: قص النص

لنبدأ بالسؤال الأبسط في التقرير: ما العمليات Processes التي تأخذ أكبر قدر من الذاكرة؟ والطريقة التي يكتبها أغلبنا أول مرة هي أن نأخذ ما يطبعه `tasklist`، ونقص كل سطر على المسافات كما نفعل بـ `awk`، ثم نرتب على عمود الذاكرة. والسكربت التالي يفعل ذلك، ويحتفظ فقط بعمليات Windows نفسها حتى يكون المخرج متشابهاً على أي جهاز، ثم يحاول مرتين أخريين بعد أن تفشل الأولى:

```powershell
# 01-text.ps1: the old way. Read the text that tasklist prints and cut it into columns.
# Only Windows' own processes are kept, so the output is the same kind of list on any Windows 11 machine.
$sys = 'System', 'Registry', 'smss.exe', 'csrss.exe', 'wininit.exe', 'services.exe', 'lsass.exe',
       'winlogon.exe', 'dwm.exe', 'explorer.exe', 'MsMpEng.exe', 'Memory Compression', 'System Idle Process'

"### 1. What tasklist gives you: lines of text"
$raw = tasklist /fo table /nh | Where-Object { $_ }
"lines: $($raw.Count), type of one line: $($raw[0].GetType().FullName)"
$raw | Select-Object -First 3

"### 2. Cut each line on spaces, as you would with awk"
$rows = foreach ($line in $raw) {
    $f = $line -split '\s+'
    [pscustomobject]@{ Name = $f[0]; PID = $f[1]; Mem = $f[4] }
}
$rows | Select-Object -First 3 | Format-Table -AutoSize | Out-String -Width 120

"### 3. Top 5 by memory, sorted as text"
$rows | Where-Object { $sys -contains $_.Name } | Sort-Object Mem -Descending |
    Select-Object -First 5 | Format-Table -AutoSize | Out-String -Width 120

"### 4. Second try: CSV output, the names are right but memory is still text"
$csv = tasklist /fo csv /nh | ConvertFrom-Csv -Header Name, PID, Session, SessionNo, Mem
$one = $csv | Where-Object Name -eq 'System' | Select-Object -First 1
"Mem of System = '$($one.Mem)', type: $($one.Mem.GetType().Name)"
$csv | Where-Object { $sys -contains $_.Name } | Sort-Object Mem -Descending |
    Select-Object -First 5 Name, Mem | Format-Table -AutoSize | Out-String -Width 120

"### 5. Third try: clean the text into a number yourself"
$csv | Where-Object { $sys -contains $_.Name } |
    Select-Object Name, @{ n = 'MemKB'; e = { [int64]($_.Mem -replace '[^\d]', '') } } |
    Sort-Object MemKB -Descending | Select-Object -First 5 | Format-Table -AutoSize | Out-String -Width 120
```

والمخرج سوف يكون كما يلي:

```text
### 1. What tasklist gives you: lines of text
lines: 552, type of one line: System.String
System Idle Process              0 Services                   0          8 K
System                           4 Services                   0     13,284 K
Secure System                  140 Services                   0    198,556 K
### 2. Cut each line on spaces, as you would with awk
Name   PID    Mem     
----   ---    ---     
System Idle   Services
System 4      13,284  
Secure System 0       

### 3. Top 5 by memory, sorted as text
Name         PID  Mem     
----         ---  ---     
System       Idle Services
csrss.exe    856  9,652   
wininit.exe  848  8,472   
csrss.exe    984  6,636   
explorer.exe 6876 590,632 
```

في المخرج أعلاه لاحظ التالي:

- السطر الثاني يقول إن `tasklist` أعطانا 552 سطراً، ونوع كل سطر `System.String`، أي نص فقط، ولا يعرف PowerShell عنه أي شيء آخر.
- العملية الأولى في الجهاز اسمها `System Idle Process`، وفيها مسافتان، فعندما قصصنا على المسافات أصبح الاسم `System` ورقم العملية `Idle` والذاكرة `Services`. والعملية `Secure System` انكسرت بالطريقة نفسها.
- في ترتيب أكبر خمس عمليات ظهر `wininit.exe` بذاكرة 8,472 فوق `explorer.exe` بذاكرة 590,632، والسبب أن الترتيب كان ترتيب نص لا ترتيب أرقام، والحرف 9 أكبر من الحرف 5\. واختفت عملية `Memory Compression` تماماً من القائمة، لأن اسمها انقص إلى `Memory` فلم يطابق القائمة التي نبحث فيها.

والمحاولة الثانية التي يلجأ إليها أغلب الناس هي أن يطلبوا من `tasklist` مخرجاً بصيغة CSV، وهذا يحل مشكلة الأسماء، ولكن انظر إلى ما بقي:

```text
### 4. Second try: CSV output, the names are right but memory is still text
Mem of System = '13,284 K', type: String

Name                Mem     
----                ---     
csrss.exe           9,624 K 
wininit.exe         8,472 K 
System Idle Process 8 K     
Registry            63,440 K
csrss.exe           6,636 K 

### 5. Third try: clean the text into a number yourself
Name                 MemKB
----                 -----
Memory Compression 5093216
explorer.exe        590632
MsMpEng.exe         499372
dwm.exe             362316
Registry             63440
```

أصبحت الأسماء صحيحة، ولكن الذاكرة ما زالت نصاً قيمته `'13,284 K'`، فيه فاصلة الآلاف وحرف K، ولذلك بقي الترتيب خاطئاً وظهرت `System Idle Process` بذاكرة 8 K في المرتبة الثالثة. والمحاولة الثالثة نجحت أخيراً، بعد أن نظفنا النص بتعبير نمطي Regular Expression يحذف كل ما ليس رقماً ثم حولناه إلى رقم بأنفسنا. والآن ظهرت `Memory Compression` في الأعلى بما يقارب خمسة غيغابايت، وهي العملية التي يضغط فيها Windows الصفحات غير المستخدمة من الذاكرة بدل أن يكتبها على القرص.

والدرس هنا ليس أن المحاولة الثالثة صعبة، وإنما أنها هشة: فهي تعتمد على أن الأمر يطبع الذاكرة بالكيلوبايت وبحرف K في آخرها، وعلى أن أسماء الأعمدة لن تتغير، وعلى أنك تعرف أن فاصلة الآلاف موجودة. وكل أداة نصية جديدة تريد أن تضيفها للتقرير تحتاج منك أن تتعلم شكل مخرجها وتكتب له منظفاً خاصاً، والشكل التالي يلخص الفرق بين الطريقتين:

![رسم من قسمين: في الأعلى سطر نص من tasklist مقطوع بخطوط حمراء عند المسافات فيصبح الاسم System ورقم العملية Idle والذاكرة Services وكلها من نوع String، وفي الأسفل كائن Process من Get-Process له خصائص ProcessName من نوع string وId من نوع int وWorkingSet64 من نوع long وStartTime من نوع datetime ودالة Kill، وسهم إلى Sort-Object WorkingSet64 الذي يقارن أرقاماً](https://arabroot.io/content/images/2026/11/powershell-basics-01-text-vs-objects.webp)

النص يحتاج من يقصه ويخمن أنواعه، والكائن يصل ومعه أسماء خصائصه وأنواعها

## الكائن Object: ماذا يرجع Get-Process فعلاً؟

الآن نسأل السؤال نفسه بطريقة PowerShell. الأمر `Get-Process` لا يطبع جدولاً، وإنما يرجع لكل عملية كائناً من نوع `System.Diagnostics.Process`، وهو الكلاس نفسه الذي يستخدمه أي برنامج مكتوب بـ C# ليقرأ العمليات. والجدول الذي تراه عندما تكتب `Get-Process` وحده في الطرفية يرسمه PowerShell في آخر لحظة، عندما لا يجد أمراً بعده يستلم الكائنات. والسكربت التالي يسأل الأسئلة نفسها التي سألناها لـ `tasklist`:

```powershell
# 02-objects.ps1: the same question asked with objects. Get-Process returns .NET objects, not text.
$sys = 'System', 'Registry', 'smss', 'csrss', 'wininit', 'services', 'lsass',
       'winlogon', 'dwm', 'explorer', 'MsMpEng', 'Memory Compression', 'Idle'

"### 1. What Get-Process gives you: objects"
$p = Get-Process
"count: $($p.Count), type of one item: $($p[0].GetType().FullName)"

"### 2. What is inside one object: Get-Member"
$props = Get-Process -Id $PID | Get-Member -MemberType Property
"properties: $($props.Count)"
Get-Process -Id $PID | Get-Member -Name Name, Id, WorkingSet64, StartTime, CPU, Kill |
    Format-Table Name, MemberType, Definition -AutoSize | Out-String -Width 120

"### 3. Top 5 by memory: sort on a number, no parsing"
$p | Where-Object { $sys -contains $_.ProcessName } | Sort-Object WorkingSet64 -Descending |
    Select-Object -First 5 ProcessName, Id, @{ n = 'MB'; e = { [math]::Round($_.WorkingSet64 / 1MB, 1) } } |
    Format-Table -AutoSize | Out-String -Width 120

"### 4. One question, one line: how many svchost and how much memory together"
$p | Where-Object ProcessName -eq 'svchost' | Measure-Object WorkingSet64 -Sum -Average -Maximum |
    Select-Object Count, @{ n = 'SumMB'; e = { [math]::Round($_.Sum / 1MB) } },
        @{ n = 'AvgMB'; e = { [math]::Round($_.Average / 1MB, 1) } }, @{ n = 'MaxMB'; e = { [math]::Round($_.Maximum / 1MB, 1) } } |
    Format-Table -AutoSize | Out-String -Width 120

"### 5. Finding commands: Verb-Noun"
"approved verbs: $((Get-Verb).Count)"
Get-Command -Noun Service | Sort-Object Name | Format-Table Name, CommandType, Source -AutoSize | Out-String -Width 120
"commands with -Verb Get: $((Get-Command -Verb Get).Count)"
```

والمخرج سوف يكون كما يلي:

```text
### 1. What Get-Process gives you: objects
count: 556, type of one item: System.Diagnostics.Process
### 2. What is inside one object: Get-Member
properties: 52

Name             MemberType Definition                                                    
----             ---------- ----------                                                    
Name          AliasProperty Name = ProcessName                                            
Id                 Property int Id {get;}                                                 
WorkingSet64       Property long WorkingSet64 {get;}                                      
StartTime          Property datetime StartTime {get;}                                     
CPU          ScriptProperty System.Object CPU {get=$this.TotalProcessorTime.TotalSeconds;}
Kill                 Method void Kill()                                                   

### 3. Top 5 by memory: sort on a number, no parsing
ProcessName          Id     MB
-----------          --     --
Memory Compression 3572 4973.1
explorer           6876  575.6
MsMpEng            5188  499.4
dwm                1596  347.1
lsass              1188   56.1

### 4. One question, one line: how many svchost and how much memory together
Count SumMB AvgMB MaxMB
----- ----- ----- -----
  108  2071  19.2  76.4
```

في المخرج أعلاه لاحظ التالي:

- نوع كل عنصر هو `System.Diagnostics.Process`، وفي هذا الكائن 52 خاصية Property، أي أن كل ما يعرفه Windows عن العملية موجود فيه، وأنت تختار منه ما تحتاج.
- الأمر [Get-Member](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-member?ref=arabroot.io) هو أهم أمر تتعلمه في PowerShell، لأنه يجيب عن السؤال «ماذا يوجد داخل هذا الشيء؟». ولاحظ أن الخاصية `WorkingSet64` من نوع `long`، أي رقم صحيح كبير بالبايت، وأن `StartTime` من نوع `datetime`، فتستطيع أن تقارنه بتاريخ آخر مباشرة دون أن تقرأ صيغة التاريخ.
- ليست كل الأعضاء Members من نوع واحد: `Name` اسم بديل AliasProperty للخاصية `ProcessName`، و`CPU` خاصية محسوبة ScriptProperty أضافها PowerShell فوق الكلاس الأصلي، و`Kill` دالة Method تنهي العملية فعلاً إذا استدعيتها، فانتبه لها.
- الترتيب في القسم الثالث صحيح من أول مرة، لأن [Sort-Object](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/sort-object?ref=arabroot.io) يقارن أرقاماً من نوع `long`، ولم نحتج إلى أي قص أو تنظيف. والعمود MB صنعناه بأنفسنا بخاصية محسوبة Calculated Property، وهي الصيغة `@{ n = 'MB'; e = { ... } }` التي تعطيها اسماً وتعبيراً يحسب قيمتها من الكائن الحالي `$_`.
- القسم الرابع يجيب عن سؤال كان يحتاج سكربتاً كاملاً بالنص: في الجهاز 108 عمليات باسم `svchost`، تأخذ معاً 2071 ميغابايت، ومتوسط الواحدة 19.2 ميغابايت. والأمر [Measure-Object](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/measure-object?ref=arabroot.io) يحسب المجموع والمتوسط والأكبر لأي خاصية رقمية.

⚠️

الكائن الذي يمر في الأنبوب حي، وليس صورة منه، فالدالة `Kill()` على كائن من `Get-Process` تنهي العملية الحقيقية في الجهاز، والأمر `Get-Process | Stop-Process` دون تصفية قبله ينهي كل ما يستطيع حسابك إنهاءه. لذلك جرب أي أمر يغير شيئاً بالخيار `-WhatIf` أولاً، فهو يطبع ما كان سيفعله دون أن يفعله.

### كيف تجد الأمر الذي تحتاجه؟ الفعل والاسم Verb-Noun

كل أوامر PowerShell المبنية فيه، والتي تسمى Cmdlets، مكتوبة بصيغة فعل ثم اسم: `Get-Process` و`Stop-Service` و`Export-Csv`. والأفعال ليست حرة، وإنما قائمة [أفعال معتمدة Approved Verbs](https://learn.microsoft.com/en-us/powershell/scripting/developer/cmdlet/approved-verbs-for-windows-powershell-commands?ref=arabroot.io) تنشرها Microsoft، وفي جهاز المختبر أعادت `Get-Verb` منها 98 فعلاً. وفائدة هذا الأسلوب أنك تستطيع أن تخمن اسم الأمر قبل أن تعرفه، ثم تتأكد منه بـ `Get-Command`:

```text
### 5. Finding commands: Verb-Noun
approved verbs: 98

Name            CommandType Source                         
----            ----------- ------                         
Get-Service          Cmdlet Microsoft.PowerShell.Management
New-Service          Cmdlet Microsoft.PowerShell.Management
Restart-Service      Cmdlet Microsoft.PowerShell.Management
Resume-Service       Cmdlet Microsoft.PowerShell.Management
Set-Service          Cmdlet Microsoft.PowerShell.Management
Start-Service        Cmdlet Microsoft.PowerShell.Management
Stop-Service         Cmdlet Microsoft.PowerShell.Management
Suspend-Service      Cmdlet Microsoft.PowerShell.Management

commands with -Verb Get: 601
```

طلبنا كل الأوامر التي اسمها Service، فظهرت ثمانية أوامر لكل ما يمكن أن تفعله بخدمة، وكلها من الوحدة Module نفسها `Microsoft.PowerShell.Management`. وفي الجهاز 601 أمر يبدأ بـ `Get`، والقاعدة المتفق عليها أن أوامر `Get` تقرأ فقط ولا تغير شيئاً، ولهذا بنينا التقرير كله منها. وعندما تجد الأمر استخدم `Get-Help Get-Service -Examples` لترى أمثلة جاهزة، و`Get-Help Get-Service -Online` ليفتح لك صفحته في موقع Microsoft Learn.

## الأنبوب Pipeline: الكائنات تمر من أمر إلى أمر

ننتقل إلى الجزء الثاني من التقرير: الخدمات التي كان يفترض أن تعمل وتوقفت. والخدمة في Windows برنامج يعمل في الخلفية دون أن يفتحه مستخدم، ولكل خدمة نوع تشغيل StartType يحدد متى تعمل: Automatic مع إقلاع الجهاز، أو Manual عندما يطلبها برنامج، أو Disabled فلا تعمل أبداً. والخدمة التي نوعها Automatic وحالتها Stopped هي أول ما يبحث عنه أي مسؤول، لأنها غالباً شيء توقف ولم يعد. والسكربت التالي يجمع الخدمات ويصنفها ويصفيها بأوامر الأنبوب الأربعة الأشهر:

```powershell
# 03-pipeline.ps1: Where-Object, Select-Object, Sort-Object and Group-Object on services.
$svc = Get-Service -ErrorAction SilentlyContinue

"### 1. Services by status"
$svc | Group-Object Status | Sort-Object Count -Descending | Format-Table Count, Name -AutoSize | Out-String -Width 120

"### 2. Services by start type"
$svc | Group-Object StartType -ErrorAction SilentlyContinue -ErrorVariable gerr | Sort-Object Count -Descending |
    Format-Table Count, Name -AutoSize | Out-String -Width 120
"errors: $($gerr.Count)  first: $($gerr[0].Exception.Message)"

"### 3. Automatic but not running"
$bad = $svc | Where-Object { $_.StartType -eq 'Automatic' -and $_.Status -ne 'Running' }
"count: $($bad.Count)"
$bad | Sort-Object Name | Select-Object Name, Status, StartType,
    @{ n = 'Trigger'; e = { (sc.exe qtriggerinfo "$($_.Name)" 2>&1 | Out-String) -match 'START SERVICE' } } |
    Format-Table -AutoSize | Out-String -Width 120
"sc is: $((Get-Alias sc).Definition)"

"### 4. The same filter with the simple syntax: one condition only"
($svc | Where-Object StartType -eq 'Automatic').Count

"### 5. A typo in the property name: no error, just nothing"
$typo = $svc | Where-Object { $_.StartTyp -eq 'Automatic' }
"result count: $(@($typo).Count)"
Set-StrictMode -Version Latest
try { $svc | Where-Object { $_.StartTyp -eq 'Automatic' } | Out-Null; 'no error' }
catch { "with StrictMode: $($_.Exception.Message)" }
Set-StrictMode -Off

"### 6. Where the time goes: filter left"
$t1 = Measure-Command { 1..20 | ForEach-Object { Get-Service | Where-Object Name -eq 'Spooler' } }
$t2 = Measure-Command { 1..20 | ForEach-Object { Get-Service -Name 'Spooler' } }
"Get-Service | Where-Object x20 : $([math]::Round($t1.TotalMilliseconds)) ms"
"Get-Service -Name x20          : $([math]::Round($t2.TotalMilliseconds)) ms"
```

والمخرج سوف يكون كما يلي:

```text
### 1. Services by status
Count Name   
----- ----   
  162 Stopped
  156 Running

### 2. Services by start type
Count Name     
----- ----     
  210 Manual   
   97 Automatic
   10 Disabled 
    1          

errors: 1  first: Exception getting "StartType": "Cannot open McmSvc service on computer '.'."
### 3. Automatic but not running
count: 7

Name                                      Status StartType Trigger
----                                      ------ --------- -------
AppXSvc                                  Stopped Automatic    True
edgeupdate                               Stopped Automatic    True
GoogleUpdaterInternalService157.0.8089.0 Stopped Automatic   False
GoogleUpdaterService157.0.8089.0         Stopped Automatic   False
Intel(R) TPM Provisioning Service        Stopped Automatic   False
MapsBroker                               Stopped Automatic   False
sppsvc                                   Stopped Automatic    True

sc is: Set-Content
### 4. The same filter with the simple syntax: one condition only
97
### 5. A typo in the property name: no error, just nothing
result count: 0
with StrictMode: The property 'StartTyp' cannot be found on this object. Verify that the property exists.
### 6. Where the time goes: filter left
Get-Service | Where-Object x20 : 289 ms
Get-Service -Name x20          : 30 ms
```

وفي هذا المخرج عدة أشياء تستحق التوقف عندها، فلنأخذها بالترتيب.

**التجميع Group-Object:** في الجهاز 318 خدمة، تعمل منها 156 ومتوقفة 162، وهذا طبيعي لأن أغلب الخدمات Manual تعمل عند الحاجة فقط. والأمر [Group-Object](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/group-object?ref=arabroot.io) يجمع الكائنات التي لها القيمة نفسها في خاصية ما، ويعطيك عددها في سطر واحد، وهو ما كنت ستكتبه بـ `sort | uniq -c` في Linux.

**المشكلة التي قابلتنا:** في التجميع الثاني ظهرت مجموعة دون اسم فيها خدمة واحدة، وظهر قبلها خطأ يقول إن PowerShell لم يستطع فتح الخدمة McmSvc. والسبب أن الخاصية `StartType` لا تأتي مع الكائن جاهزة، وإنما يقرؤها PowerShell من مدير الخدمات عندما تطلبها، وهذه الخدمة بالذات لا تسمح لمستخدم عادي بقراءة إعداداتها. وفي أول تشغيل ظهر الخطأ بكامله مع مسار السكربت، فأضفنا `-ErrorAction SilentlyContinue -ErrorVariable gerr` حتى يكمل الأمر عمله ونطبع الخطأ في سطر واحد. وهذا شيء ستقابله كثيراً عندما تعمل دون صلاحيات المدير: الأمر يعمل، ولكن بعض الكائنات تنقصها معلومة، وعليك أن تقرر هل تتجاهلها أم تذكرها في التقرير.

**التصفية Where-Object:** الأمر [Where-Object](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/where-object?ref=arabroot.io) يمرر كل كائن على شرط، ويترك فقط الكائنات التي يتحقق فيها الشرط، وداخل الأقواس المعقوفة يشير `$_` إلى الكائن الحالي. ووجدنا سبع خدمات Automatic متوقفة. وفي القسم الرابع كتبنا الشرط بالصيغة المختصرة `Where-Object StartType -eq 'Automatic'` دون أقواس، وهي أسهل في القراءة، ولكنها تقبل شرطاً واحداً فقط، فإذا احتجت شرطين مع `-and` فارجع إلى صيغة الأقواس.

**هل كل خدمة متوقفة مشكلة؟** لا، وهذا أهم شيء في هذا القسم. فمن الخدمات السبع، ثلاث لها مشغل Trigger، أي أنها مسجلة لكي يشغلها Windows عند حدث معين ثم تتوقف بنفسها عندما لا يكون لديها عمل، كما تشرح [صفحة Service Trigger Events](https://learn.microsoft.com/en-us/windows/win32/services/service-trigger-events?ref=arabroot.io) في توثيق Windows. فالخدمة `AppXSvc` مثلاً يقول وصفها في الجهاز إنها تجهز تطبيقات المتجر وإنها تعمل عند الطلب On Demand، ورؤيتها متوقفة لا تعني شيئاً. ولو وضعنا هذه الخدمات في التقرير لاعتاد المدير على تجاهل قائمة الخدمات كلها بعد أسبوع، وهذا أسوأ من ألا يوجد تقرير.

ولكن من أين نعرف أن للخدمة مشغلاً؟ هنا قابلنا حداً حقيقياً للكائنات: الكائن الذي يرجعه `Get-Service` لا يحتوي معلومات المشغلات، والطريقة الوحيدة المتاحة دون برمجة هي الأداة `sc.exe qtriggerinfo` التي تطبع نصاً. لذلك عدنا إلى النص في هذه النقطة فقط، وبحثنا فيه عن العبارة `START SERVICE` التي تطبعها الأداة عندما يكون للخدمة مشغل يشغلها، وهو بحث عن عبارة ثابتة لا قص أعمدة، فلا ينكسر بسهولة. ولاحظ في السطر الأخير من القسم الثالث أن `sc` وحدها في Windows PowerShell هي اسم بديل Alias للأمر `Set-Content` الذي يكتب في الملفات، ولذلك يجب أن تكتب `sc.exe` كاملة، وإلا فإن الأمر `sc qtriggerinfo AppXSvc` لا يسأل عن الخدمة أبداً، وإنما ينشئ في المجلد الحالي ملفاً اسمه `qtriggerinfo` ويكتب فيه كلمة AppXSvc، وهذا ما حدث فعلاً عندما جربناه.

![أربعة صناديق متصلة بخطوط أنبوب: Get-Service يخرج 318 كائناً، ثم Where-Object يبقي 7 خدمات Automatic لا تعمل، ثم Where-Object ثان يبقي 4 ليس لها Trigger، ثم Select-Object يبقي خاصيتين، ثم سهمان إلى ملفي issues.csv وreport.json، وتحتها بطاقة كائن ServiceController فيه Name وStatus وStartType، وبطاقة تشرح أن $_ هو الكائن الحالي](https://arabroot.io/content/images/2026/11/powershell-basics-02-pipeline.webp)

في الأنبوب تمر كائنات كاملة، وكل أمر يأخذ منها ما يحتاجه ويمرر الباقي

**خطأ في اسم الخاصية:** في القسم الخامس كتبنا `StartTyp` بدل `StartType` عن قصد، والنتيجة صفر خدمات ولا يوجد أي خطأ. والسبب أن PowerShell يعيد `$null` عندما تطلب خاصية غير موجودة، و`$null` لا يساوي `'Automatic'`، فيبدو الأمر وكأنه لا توجد أي خدمة بهذه الصفة. وهذا أخطر من رسالة خطأ، لأن التقرير سوف يقول للمدير «لا توجد مشكلات» وهو في الحقيقة لم يبحث. والحل هو [Set-StrictMode -Version Latest](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/set-strictmode?ref=arabroot.io) في أول السكربت، فعندها أصبح الخطأ نفسه رسالة واضحة تقول إن الخاصية `StartTyp` غير موجودة.

**التصفية أولاً Filter Left:** في القسم السادس طلبنا خدمة واحدة عشرين مرة بطريقتين: الأولى تجلب الخدمات كلها ثم تصفيها بـ `Where-Object`، واستغرقت 289 ملي ثانية، والثانية تطلب الخدمة باسمها من `Get-Service -Name`، واستغرقت 30 ملي ثانية، أي أسرع بنحو عشر مرات. والفرق هنا صغير لأن عدد الخدمات صغير، ولكن [دليل Microsoft](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/04-pipelines?ref=arabroot.io) يذكر مثال Active Directory: لا معنى لأن تجلب آلاف الحسابات من الشبكة ثم تختار منها حساباً واحداً، والأمر يقبل التصفية بنفسه. لذلك القاعدة أن تبحث أولاً هل للأمر خيار يصفي، ولا تستخدم `Where-Object` إلا لما لا يستطيعه الأمر.

## Format-Table في آخر الأنبوب فقط

الخطأ التالي يقع فيه كل من يبدأ مع PowerShell تقريباً: تريد أن تختار عمودين من الخدمات وتحفظهما في ملف CSV، والأمر الذي تعرفه لاختيار الأعمدة هو `Format-Table` لأنك تراه في الأمثلة، فتكتب `Get-Service | Format-Table Name, Status | Export-Csv`. والسكربت التالي يفعل ذلك، ثم يسأل ماذا خرج فعلاً من `Format-Table`، ثم يجرب الطريقة الصحيحة:

```powershell
# 05-format-trap.ps1: what happens when Format-Table sits in the middle of the pipeline.
$out = Join-Path $PSScriptRoot 'out-5'
New-Item -ItemType Directory -Force $out | Out-Null

"### 1. Format-Table, then Export-Csv"
Get-Service -Name Spooler, W32Time, BITS | Format-Table Name, Status | Export-Csv (Join-Path $out 'trap.csv') -NoTypeInformation
$lines = Get-Content (Join-Path $out 'trap.csv')
"lines in the file: $($lines.Count)"
"header: $($lines[0].Substring(0, [math]::Min(110, $lines[0].Length)))..."

"### 2. What Format-Table really sends down the pipe"
Get-Service -Name Spooler, W32Time, BITS | Format-Table Name, Status | ForEach-Object { $_.GetType().Name } |
    Group-Object | Format-Table Count, Name -AutoSize | Out-String -Width 120

"### 3. Select-Object instead: real objects, a real CSV"
Get-Service -Name Spooler, W32Time, BITS | Select-Object Name, Status | Export-Csv (Join-Path $out 'ok.csv') -NoTypeInformation
Get-Content (Join-Path $out 'ok.csv')
```

والمخرج سوف يكون كما يلي:

```text
### 1. Format-Table, then Export-Csv
lines in the file: 8
header: "ClassId2e4f51ef21dd47e99d3c952918aff9cd","pageHeaderEntry","pageFooterEntry","autosizeInfo","shapeInfo","grou...
### 2. What Format-Table really sends down the pipe
Count Name           
----- ----           
    1 FormatStartData
    1 GroupStartData 
    3 FormatEntryData
    1 GroupEndData   
    1 FormatEndData  

### 3. Select-Object instead: real objects, a real CSV
"Name","Status"
"BITS","Running"
"Spooler","Running"
"W32Time","Stopped"
```

في الملف الأول ثمانية أسطر لثلاث خدمات، وعنوانه أعمدة بأسماء غريبة مثل `ClassId2e4f51ef21dd47e99d3c952918aff9cd` و`pageHeaderEntry`، ولا يوجد فيه اسم أي خدمة. والقسم الثاني يشرح السبب: [Format-Table](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/format-table?ref=arabroot.io) لا يمرر الكائنات، وإنما يحولها إلى سجلات تعليمات عرض، سجل يبدأ الجدول وسجل يبدأ المجموعة وسجل لكل صف وسجلان للإغلاق، وهي سبعة سجلات لا يفهمها إلا نظام العرض في الطرفية. و`Export-Csv` فعل ما يفعله دائماً، فكتب خصائص الكائنات التي وصلته، وهي خصائص سجلات العرض. أما [Select-Object](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/select-object?ref=arabroot.io) فيصنع كائنات جديدة فيها الخصائص التي اخترتها فقط، فخرج الملف الثاني صحيحاً كما تتوقع.

![رسم من قسمين: في الأعلى Get-Service بثلاث خدمات ثم Format-Table بالأحمر يخرج سبعة سجلات عرض FormatStartData وGroupStartData وثلاثة FormatEntryData وGroupEndData وFormatEndData ثم Export-Csv يكتب ملفاً عنوانه ClassId2e4f، وفي الأسفل الطريق نفسه مع Select-Object بالأخضر يخرج ثلاثة كائنات بخاصيتين وملف CSV فيه Name وStatus لثلاث خدمات](https://arabroot.io/content/images/2026/11/powershell-basics-03-format-trap.webp)

أوامر Format تحول الكائنات إلى تعليمات عرض، فضعها في آخر الأنبوب دائماً

والقاعدة التي تخرج بها: اجعل التصفية في أول الأنبوب Filter Left، واجعل أوامر `Format-*` في آخره Format Right، ولا تضع بعدها أي أمر إلا `Out-File` أو `Out-String` إذا أردت أن تحفظ الجدول كما يظهر على الشاشة. وإذا كنت تكتب سكربتاً يستخدمه غيرك فلا تضع `Format-Table` فيه أصلاً، بل أرجع الكائنات، ودع من يستدعي السكربت يقرر هل يعرضها أم يصدرها أم يمررها لأمر آخر.

## التصدير: CSV للبشر وJSON للأنظمة

التقرير له قارئان: المدير الذي يريد ملفاً يفتحه في Excel، ونظام المراقبة الذي يريد بيانات منظمة يقرؤها برنامج. والصيغة المناسبة للأول CSV لأنها جدول مسطح، والصيغة المناسبة للثاني JSON لأنها تحفظ البيانات المتداخلة كما هي، مثل قائمة الأقراص داخل التقرير وحدود التحذير داخل كل قرص. وهنا تظهر أولى الفروق المهمة بين Windows PowerShell 5.1 وPowerShell 7، لذلك يبني السكربت التالي بياناته بنفسه بدل أن يقرأها من الجهاز، حتى تأخذ النسختان المدخلات نفسها بالضبط، ثم نشغله في النسختين:

```powershell
# 04-export.ps1: CSV, JSON and file encoding. Runs the same way in Windows PowerShell 5.1 (on the host)
# and PowerShell 7 (in Docker), so the differences come from the version, not from the data.
# The data is built here, not read from the machine, so both versions get the same input.
$out = Join-Path $PSScriptRoot "out-$($PSVersionTable.PSVersion.Major)"
New-Item -ItemType Directory -Force $out | Out-Null
"### 0. Version"
"PowerShell $($PSVersionTable.PSVersion) ($($PSVersionTable.PSEdition))"

$disks = @(
    [pscustomobject]@{ Drive = 'C:'; SizeGB = 476.3; FreeGB = 61.2 },
    [pscustomobject]@{ Drive = 'D:'; SizeGB = 931.5; FreeGB = 120.4 }
)

"### 1. Export-Csv with no options: the first lines of the file"
$disks | Export-Csv (Join-Path $out 'disks.csv')
Get-Content (Join-Path $out 'disks.csv') | Select-Object -First 3

"### 2. Export-Csv -NoTypeInformation"
$disks | Export-Csv (Join-Path $out 'disks2.csv') -NoTypeInformation
Get-Content (Join-Path $out 'disks2.csv') | Select-Object -First 3

"### 3. Import-Csv: everything comes back as text"
$back = Import-Csv (Join-Path $out 'disks2.csv')
"FreeGB type after import: $($back[0].FreeGB.GetType().Name)"
"sorted as text : $(($back | Sort-Object FreeGB -Descending).Drive -join ', ')"
"sorted as number: $(($back | Sort-Object { [double]$_.FreeGB } -Descending).Drive -join ', ')"

"### 4. ConvertTo-Json with the default depth (2)"
$report = [pscustomobject]@{
    Machine = 'PC-01'
    Checks  = [pscustomobject]@{
        Disk = [pscustomobject]@{ Drive = 'C:'; FreePct = 12.8; Limits = [pscustomobject]@{ Warn = 15; Crit = 5 } }
    }
}
$report | ConvertTo-Json

"### 5. ConvertTo-Json -Depth 5"
$report | ConvertTo-Json -Depth 5

"### 6. The > operator: first bytes of the file"
'PC-01 OK' > (Join-Path $out 'redirect.txt')
$b = [System.IO.File]::ReadAllBytes((Join-Path $out 'redirect.txt'))
"size: $($b.Length) bytes, first 6: $(($b[0..5] | ForEach-Object { $_.ToString('X2') }) -join ' ')"
```

والمخرج في Windows PowerShell 5.1 للأقسام الثلاثة الأولى سوف يكون كما يلي:

```text
### 0. Version
PowerShell 5.1.26100.9711 (Desktop)
### 1. Export-Csv with no options: the first lines of the file
#TYPE System.Management.Automation.PSCustomObject
"Drive","SizeGB","FreeGB"
"C:","476.3","61.2"
### 2. Export-Csv -NoTypeInformation
"Drive","SizeGB","FreeGB"
"C:","476.3","61.2"
"D:","931.5","120.4"
### 3. Import-Csv: everything comes back as text
FreeGB type after import: String
sorted as text : C:, D:
sorted as number: D:, C:
```

وفي PowerShell 7.6:

```text
### 0. Version
PowerShell 7.6.10 (Core)
### 1. Export-Csv with no options: the first lines of the file
"Drive","SizeGB","FreeGB"
"C:","476.3","61.2"
"D:","931.5","120.4"
### 2. Export-Csv -NoTypeInformation
"Drive","SizeGB","FreeGB"
"C:","476.3","61.2"
"D:","931.5","120.4"
### 3. Import-Csv: everything comes back as text
FreeGB type after import: String
sorted as text : C:, D:
sorted as number: D:, C:
```

في المخرجين أعلاه لاحظ التالي:

- في 5.1 يكتب [Export-Csv](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-csv?ref=arabroot.io) سطراً أولاً يبدأ بـ `#TYPE` فيه اسم نوع الكائن، وهذا السطر يظهر في Excel كأنه صف من البيانات ويفسد أول عمود في أي برنامج آخر، ولذلك ترى `-NoTypeInformation` في كل سكربت كتب لـ 5.1\. وفي PowerShell 7 أصبح هذا هو السلوك الافتراضي، كما يذكر [دليل الفروق](https://learn.microsoft.com/en-us/powershell/scripting/whats-new/differences-from-windows-powershell?ref=arabroot.io)، فلم يظهر السطر في القسم الأول. والحل الذي يعمل في النسختين أن تكتب `-NoTypeInformation` دائماً.
- في القسم الثالث، القيم التي ترجع من `Import-Csv` كلها نصوص في النسختين، لأن ملف CSV لا يحفظ الأنواع. فعندما رتبنا الأقراص على المساحة الحرة كنص جاء القرص C بمساحة 61.2 قبل القرص D بمساحة 120.4، لأن الحرف 6 أكبر من الحرف 1، وعندما حولنا القيمة إلى رقم داخل `Sort-Object` رجع الترتيب صحيحاً. أي أن CSV يعيدك إلى مشكلة النص نفسها التي بدأنا منها، ولذلك هو صيغة للعرض على البشر لا لتبادل البيانات بين السكربتات.

أما JSON فقصته أخطر، لأن الفرق بين النسختين فيه هو الفرق بين بيانات ناقصة بصمت وبيانات ناقصة مع تحذير. وهذا مخرج القسم الرابع في 5.1:

```text
### 4. ConvertTo-Json with the default depth (2)
{
    "Machine":  "PC-01",
    "Checks":  {
                   "Disk":  {
                                "Drive":  "C:",
                                "FreePct":  12.8,
                                "Limits":  "@{Warn=15; Crit=5}"
                            }
               }
}
```

وهذا المخرج نفسه في PowerShell 7.6:

```text
### 4. ConvertTo-Json with the default depth (2)
WARNING: Resulting JSON is truncated as serialization has exceeded the set depth of 2.
{
  "Machine": "PC-01",
  "Checks": {
    "Disk": {
      "Drive": "C:",
      "FreePct": 12.8,
      "Limits": "@{Warn=15; Crit=5}"
    }
  }
}
```

التقرير الذي بنيناه فيه أربعة مستويات: التقرير، ثم `Checks`، ثم `Disk`، ثم `Limits`. و[ConvertTo-Json](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/convertto-json?ref=arabroot.io) يتوقف افتراضياً عند العمق 2، وما بعده يحوله إلى نص بالطريقة التي يطبع بها PowerShell الكائن، فأصبحت `Limits` النص `"@{Warn=15; Crit=5}"` بدل كائن فيه رقمان. والفرق أن 5.1 فعل ذلك بصمت، أما PowerShell 7 فطبع تحذيراً واضحاً، وهذا التحذير [أضيف في PowerShell 7.1](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/convertto-json?ref=arabroot.io)، ويقول التوثيق إن الهدف منه منع فقدان البيانات دون قصد. ونظام المراقبة الذي يقرأ هذا الملف سوف يجد نصاً حيث ينتظر رقماً، وأي تنبيه يعتمد على `Limits.Warn` لن يعمل أبداً. والحل أن تحدد العمق بنفسك دائماً، وفي القسم الخامس كتبنا `-Depth 5` فخرج الكائن كاملاً في النسختين، والقيمة القصوى المسموحة 100.

والفرق الثالث في ترميز الملفات Encoding، وهذا مخرج القسم السادس في النسختين على الترتيب:

```text
### 6. The > operator: first bytes of the file
size: 22 bytes, first 6: FF FE 50 00 43 00
### 6. The > operator: first bytes of the file
size: 9 bytes, first 6: 50 43 2D 30 31 20
```

كتبنا النص نفسه `PC-01 OK` بالعامل `>`، فخرج في 5.1 ملف حجمه 22 بايت يبدأ بالبايتين `FF FE`، وهما علامة ترتيب البايت BOM لترميز UTF-16LE، ثم كل حرف في بايتين، `50 00` للحرف P و`43 00` للحرف C. وخرج في PowerShell 7 ملف حجمه 9 بايت فقط، بترميز UTF-8 دون BOM. و[صفحة الترميز في توثيق PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about%5Fcharacter%5Fencoding?ref=arabroot.io) تقول صراحة إن الترميز الافتراضي في Windows PowerShell غير متسق بين الأوامر: `Out-File` والعامل `>` يكتبان UTF-16LE، و`Set-Content` يكتب بصفحة الترميز ANSI للنظام، و`Export-Csv` يكتب ASCII، بينما PowerShell 7 يكتب `utf8NoBOM` في كل شيء. وفي الواقع هذا يعني أن ملفاً أنشأه سكربتك بـ `>` قد يظهر لأداة Linux أو لبرنامج يقرأ UTF-8 كأن بين كل حرفين حرفاً فارغاً. والحل في 5.1 أن تحدد `-Encoding UTF8` في كل أمر يكتب ملفاً، كما فعلنا في سكربت التقرير.

## Windows PowerShell 5.1 أم PowerShell 7؟

رأينا ثلاثة فروق في التصدير، وبقي فرق رابع يخصنا نحن تحديداً لأننا نكتب بالعربية: ترميز ملف السكربت نفسه. فإذا حفظت سكربتاً فيه نص عربي من محرر مثل VS Code، فالمحرر يحفظه افتراضياً UTF-8 دون BOM. والسكربت التالي يكتب ملفي سكربت فيهما كلمة «تقرير»، أحدهما UTF-8 دون BOM والآخر معه، ثم يشغلهما في النسخة نفسها التي تشغله:

```powershell
# 07-bom.ps1: a script with Arabic text, saved as UTF-8 with and without a BOM, run by this PowerShell.
# This file itself stays ASCII; the Arabic word is built from its code points.
$word = -join ([char[]](0x062A, 0x0642, 0x0631, 0x064A, 0x0631))     # the word "report" in Arabic, 5 letters
$body = "`$s = '$word'`r`n'length={0} first=U+{1:X4}' -f `$s.Length, [int][char]`$s[0]`r`n"
$dir = Join-Path $PSScriptRoot "out-$($PSVersionTable.PSVersion.Major)"
New-Item -ItemType Directory -Force $dir | Out-Null
$exe = (Get-Process -Id $PID).Path
"### $($PSVersionTable.PSVersion.Major). PowerShell $($PSVersionTable.PSVersion)"
foreach ($bom in $false, $true) {
    $f = Join-Path $dir ("arabic-{0}.ps1" -f $(if ($bom) { 'bom' } else { 'nobom' }))
    [System.IO.File]::WriteAllText($f, $body, [System.Text.UTF8Encoding]::new($bom))
    # run it in a new PowerShell and catch the parse error, so the message can be printed without the full path
    $r = & $exe -NoProfile -ExecutionPolicy Bypass -Command "try { & '$f' } catch { 'ERROR: ' + `$_.Exception.Message }"
    $r = ($r -join ' | ').Replace($dir + [System.IO.Path]::DirectorySeparatorChar, '')
    "{0,-12} {1}" -f $(if ($bom) { 'UTF-8 BOM' } else { 'UTF-8 only' }), $r
}
```

والمخرج في النسختين سوف يكون كما يلي:

```text
### 5. PowerShell 5.1.26100.9711
UTF-8 only   ERROR: At arabic-nobom.ps1:1 char:11 | + $s = 'OªU,O±USO±' | +           ~~~~~~~ | Unexpected token 'O±USO±' | 'length=' in expression or statement. |  | At arabic-nobom.ps1:2 char:27 | + 'length={0} first=U+{1:X4}' -f $s.Length, [int][char]$s[0] | +                           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | The string is missing the terminator: '.
UTF-8 BOM    length=5 first=U+062A

### 7. PowerShell 7.6.10
UTF-8 only   length=5 first=U+062A
UTF-8 BOM    length=5 first=U+062A
```

في 5.1 لم يعمل الملف الذي ليس فيه BOM أصلاً، فقد قرأ PowerShell الكلمة العربية كأنها حروف لاتينية `OªU,O±USO±`، والسبب أن حرف القاف في UTF-8 يكتب بالبايتين `D9 82`، والبايت `82` في صفحة الترميز Windows-1252 المستخدمة في جهاز المختبر هو علامة الاقتباس المائلة `‚`، و[PowerShell يعامل علامات الاقتباس المائلة](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about%5Fquoting%5Frules?ref=arabroot.io) كأنها علامات اقتباس عادية، فانتهى النص في منتصف الكلمة وظهر خطأ في تحليل السكربت. وهذا السلوك موثق في صفحة الترميز نفسها: Windows PowerShell يقرأ الملف الذي ليس فيه BOM بصفحة الترميز ANSI، ولذلك يوصي التوثيق بحفظ أي سكربت فيه حروف غير إنجليزية بترميز UTF-8 مع BOM. وأسوأ من الخطأ أن يعمل السكربت ويطبع كلاماً مشوهاً في تقرير المدير، وهذا ما يحدث عندما لا يصادف النص بايتاً يكسر التحليل. أما PowerShell 7 فقرأ الملفين بشكل صحيح، والكلمة خمسة أحرف أولها U+062A وهو حرف التاء.

والشكل التالي يجمع ما رأيناه من فروق مع الخط الزمني للإصدارات:

![في الأعلى خط زمني من 2006 إلى 2026 عليه الإصدار 1.0 ثم 2.0 مع Windows 7 ثم 5.1 مع Windows 10 ثم فتح المصدر على Linux في 2016 ثم 6.0 على .NET Core في 2018 ثم 7.0 LTS في 2020 ثم 7.6 LTS في 2026، وفي الأسفل بطاقتان متجاورتان: Windows PowerShell 5.1 باللون الأزرق وPowerShell 7.6 LTS باللون البرتقالي، وفي كل منهما اسم البرنامج ونسخة .NET وترميز العامل > وسلوك Export-Csv وConvertTo-Json وملف UTF-8 دون BOM](https://arabroot.io/content/images/2026/11/powershell-basics-04-versions.webp)

نسختان من PowerShell على الجهاز نفسه، ولكل منهما سلوك مختلف

فأي نسخة تستخدم؟ القاعدة العملية التي نقترحها:

- **سكربت يعمل على كل أجهزة الشركة دون تثبيت شيء:** اكتبه لـ 5.1، لأنها موجودة في كل جهاز Windows ولا تحتاج تثبيتاً، وتجنب فيه الأخطاء الأربعة التي رأيناها: `-NoTypeInformation` مع `Export-Csv`، و`-Depth` مع `ConvertTo-Json`، و`-Encoding UTF8` مع كل ملف تكتبه، وحفظ السكربت نفسه UTF-8 مع BOM إذا كان فيه أي حرف عربي.
- **أداتك أنت على جهازك وعلى السيرفرات التي تديرها:** ثبت PowerShell 7 بجانب 5.1، فهو لا يحل محلها، وتجد طريقة التثبيت في [دليل التثبيت على Windows](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?ref=arabroot.io). واختر إصدار الدعم الطويل 7.6، والذي [ينتهي دعمه في 14 نوفمبر 2028](https://learn.microsoft.com/en-us/powershell/scripting/install/powershell-support-lifecycle?ref=arabroot.io)، ولاحظ أن الإصدارين 7.4 و7.5 انتهى دعمهما في 10 نوفمبر 2026، فإذا كان أحدهما في جهازك فقد حان وقت الترقية.
- **أوامر قديمة لن تجدها في 7:** `Get-WmiObject` وأوامر `*-EventLog` حذفت من PowerShell 7 كما يذكر [دليل الفروق](https://learn.microsoft.com/en-us/powershell/scripting/whats-new/differences-from-windows-powershell?ref=arabroot.io)، وبديلاها `Get-CimInstance` و`Get-WinEvent`، وهما يعملان في 5.1 أيضاً. لذلك استخدم البديلين في كل سكربت جديد حتى يعمل في النسختين، وهذا ما فعلناه في سكربت التقرير.
- **وأداة `wmic`:** إذا كانت لديك سكربتات قديمة تعتمد عليها فهي [لم تعد موجودة](https://learn.microsoft.com/en-us/windows/whats-new/deprecated-features?ref=arabroot.io) في Windows 11 من الإصدار 24H2، ولا يمكن إضافتها حتى كميزة اختيارية، وتنصح Microsoft باستخدام PowerShell بدلاً منها. وهذا ما بدأنا به القصة في أول المقال.

## سكربت التقرير الصباحي

الآن نجمع كل ما تعلمناه في السكربت الذي طلبه المدير. والسكربت يقرأ خمسة مصادر، كلها أوامر `Get` لا تغير شيئاً: نظام التشغيل والذاكرة من [Get-CimInstance](https://learn.microsoft.com/en-us/powershell/module/cimcmdlets/get-ciminstance?ref=arabroot.io) بالكلاس `Win32_OperatingSystem`، والأقراص بالكلاس `Win32_LogicalDisk`، وأكبر العمليات من `Get-Process`، والخدمات المتوقفة من `Get-Service` مع فحص المشغلات بـ `sc.exe`، والأخطاء من سجل System بـ [Get-WinEvent](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.diagnostics/get-winevent?ref=arabroot.io). ثم يجمع كل مشكلة يجدها في قائمة واحدة، ويكتب منها ملفين: `issues.csv` فيه سطر لكل مشكلة للمدير، و`report.json` فيه الصورة الكاملة لنظام المراقبة، ويطبع ملخصاً من أربعة أسطر على الشاشة:

![خمسة صناديق على اليسار: Get-CimInstance Win32_OperatingSystem وGet-CimInstance Win32_LogicalDisk بنسب المساحة الحرة 2.6 و6.8 و2.5 بالمئة وGet-Process وGet-Service مع sc.exe qtriggerinfo و Get-WinEvent بسبعة وثلاثين خطأ، تتصل كلها بصندوق أسود في الوسط اسمه $issues فيه الرقم 9، ومنه ثلاثة أسهم إلى issues.csv للمدير وreport.json لنظام المراقبة وملخص على الشاشة](https://arabroot.io/content/images/2026/11/powershell-basics-05-report.webp)

سكربت التقرير الصباحي، خمسة مصادر وقائمة مشكلات واحدة وملفان

وهذا السكربت كاملاً:

```powershell
<#
.SYNOPSIS
    Morning health report for one Windows machine: disks, memory, services, recent errors.
.DESCRIPTION
    Needs no administrator rights. Writes issues.csv (one row per problem, for Excel) and
    report.json (the full picture, for a monitoring system), and prints a short summary.
.EXAMPLE
    .\06-report.ps1 -Label PC-01 -OutDir .\reports
#>
[CmdletBinding()]
param(
    [string]$Label = $env:COMPUTERNAME,         # the name written in the report
    [string]$OutDir,                            # default: reports folder next to the script (set below)
    [int]$DiskWarnPct = 15,                     # free space below this is a warning
    [int]$Hours = 24,                           # how far back to read the System log
    [int]$JsonDepth = 4,
    # services you checked and accepted as stopped (wildcards allowed)
    [string[]]$IgnoreServices = @()
)
$ErrorActionPreference = 'Stop'
# In Windows PowerShell 5.1 $PSScriptRoot is still empty while the param() defaults are computed, so set it here
if (-not $OutDir) { $OutDir = Join-Path $PSScriptRoot 'reports' }
New-Item -ItemType Directory -Force $OutDir | Out-Null
$issues = [System.Collections.Generic.List[object]]::new()
function Add-Issue($Area, $Item, $Detail, $Level) {
    $issues.Add([pscustomobject]@{ Machine = $Label; Area = $Area; Item = $Item; Detail = $Detail; Level = $Level })
}

# 1. operating system and uptime
$os = Get-CimInstance Win32_OperatingSystem
$uptime = (Get-Date) - $os.LastBootUpTime
$memFreePct = [math]::Round($os.FreePhysicalMemory / $os.TotalVisibleMemorySize * 100, 1)
if ($uptime.TotalDays -gt 30) { Add-Issue 'OS' 'Uptime' ("{0:N0} days without restart" -f $uptime.TotalDays) 'Warning' }

# 2. local fixed disks
$disks = Get-CimInstance Win32_LogicalDisk -Filter 'DriveType=3' | ForEach-Object {
    $pct = [math]::Round($_.FreeSpace / $_.Size * 100, 1)
    if ($pct -lt $DiskWarnPct) { Add-Issue 'Disk' $_.DeviceID "$pct% free" 'Warning' }
    [pscustomobject]@{ Drive = $_.DeviceID; SizeGB = [math]::Round($_.Size / 1GB, 1)
                       FreeGB = [math]::Round($_.FreeSpace / 1GB, 1); FreePct = $pct }
}

# 3. memory: the five biggest processes
$top = Get-Process | Sort-Object WorkingSet64 -Descending | Select-Object -First 5 |
    ForEach-Object { [pscustomobject]@{ Name = $_.ProcessName; Id = $_.Id; MB = [math]::Round($_.WorkingSet64 / 1MB) } }

# 4. services set to Automatic that are not running
# A trigger-start service runs when an event needs it and stops again, so stopped is normal for it.
# Windows exposes triggers only through sc.exe (text), not through Get-Service. Note: in Windows PowerShell
# "sc" alone is an alias of Set-Content, so the .exe must be written.
function Test-Trigger([string]$Name) { (sc.exe qtriggerinfo "$Name" 2>&1 | Out-String) -match 'START SERVICE' }
$stopped = Get-Service -ErrorAction SilentlyContinue | Where-Object {
    $s = $_
    $s.StartType -eq 'Automatic' -and $s.Status -ne 'Running' -and
    -not ($IgnoreServices | Where-Object { $s.Name -like $_ })
} | Where-Object { -not (Test-Trigger $_.Name) }
foreach ($s in $stopped) { Add-Issue 'Service' $s.Name "$($s.Status), start type Automatic" 'Warning' }

# 5. errors in the System log for the last $Hours hours (Level 1 = Critical, 2 = Error)
$since = (Get-Date).AddHours(-$Hours)
$events = @(Get-WinEvent -FilterHashtable @{ LogName = 'System'; Level = 1, 2; StartTime = $since } -ErrorAction SilentlyContinue)
$bySource = $events | Group-Object ProviderName | Sort-Object Count -Descending |
    ForEach-Object { [pscustomobject]@{ Source = $_.Name; Count = $_.Count; LastId = $_.Group[0].Id } }
foreach ($g in $bySource) { Add-Issue 'EventLog' $g.Source "$($g.Count) errors in $Hours h (last id $($g.LastId))" 'Error' }

# 6. write the two files and print the summary
$report = [pscustomobject]@{
    Machine = $Label; CreatedAt = (Get-Date).ToString('s'); PowerShell = "$($PSVersionTable.PSVersion)"
    OS = [pscustomobject]@{ Name = $os.Caption; Build = $os.BuildNumber; UptimeDays = [math]::Round($uptime.TotalDays, 1)
                            MemoryFreePct = $memFreePct }
    Disks = @($disks); TopProcesses = @($top); StoppedServices = @($stopped | Select-Object -ExpandProperty Name)
    Errors = @($bySource); Issues = $issues.Count
}
$issues | Export-Csv (Join-Path $OutDir 'issues.csv') -NoTypeInformation -Encoding UTF8
$report | ConvertTo-Json -Depth $JsonDepth | Set-Content (Join-Path $OutDir 'report.json') -Encoding UTF8

"{0}  {1} build {2}  up {3:N1} days  RAM free {4}%" -f $Label, $os.Caption, $os.BuildNumber, $uptime.TotalDays, $memFreePct
$disks | ForEach-Object { "disk {0} {1} GB free of {2} GB ({3}%)" -f $_.Drive, $_.FreeGB, $_.SizeGB, $_.FreePct }
"services Automatic but stopped: $(@($stopped).Count)   System errors in $Hours h: $($events.Count) from $(@($bySource).Count) sources"
"issues: $($issues.Count)  ->  $(Join-Path (Split-Path $OutDir -Leaf) 'issues.csv'), $(Join-Path (Split-Path $OutDir -Leaf) 'report.json')"
```

في السكربت أعلاه لاحظ التالي:

- **التعليق في أوله** بين `<#` و`#>` ليس تعليقاً عادياً، وإنما مساعدة مبنية Comment-Based Help، فعندما يكتب زميلك `Get-Help .\06-report.ps1 -Examples` سوف يرى الوصف والمثال كأنه أمر من أوامر PowerShell.
- **الكتلة `param()`** تجعل الإعدادات خيارات للسكربت بدل أن تكون أرقاماً مكتوبة في داخله: حد التحذير للقرص، وعدد الساعات التي يقرؤها من السجل، وعمق JSON، وقائمة الخدمات التي فحصتها وقررت أن توقفها مقبول. و`[CmdletBinding()]` تعطيه الخيارات العامة مثل `-Verbose` و`-ErrorAction` كأي أمر مبني.
- **المشكلة الثانية التي قابلتنا:** في النسخة الأولى كانت القيمة الافتراضية للخيار `OutDir` هي `(Join-Path $PSScriptRoot 'reports')`، وعند التشغيل في 5.1 فشل السكربت قبل أن يبدأ برسالة تقول إن المسار فارغ، لأن المتغير `$PSScriptRoot` كان فارغاً في اللحظة التي تحسب فيها القيم الافتراضية. فجعلنا الخيار فارغاً، وحسبنا المسار في أول سطر بعد `param()`، حيث يكون المتغير جاهزاً.
- `**$ErrorActionPreference = 'Stop'**` يجعل أي خطأ يوقف السكربت بدل أن يكمل بنصف بيانات، لأن تقريراً ناقصاً يبدو سليماً أخطر من تقرير لم يصل. واستثنينا منه الأمرين اللذين نتوقع منهما أخطاء عادية بـ `-ErrorAction SilentlyContinue`: `Get-Service` بسبب خدمات مثل McmSvc، و`Get-WinEvent` لأنه يعتبر عدم وجود أحداث في الفترة خطأ.
- **القائمة `List[object]`** بدل المصفوفة العادية `@()` مع `+=`، لأن المصفوفة ثابتة الحجم، و`+=` في 5.1 وفي كل إصدار قبل 7.5 تنشئ مصفوفة جديدة وتنسخ فيها كل العناصر مع كل إضافة، كما يشرح [دليل الأداء في توثيق PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/dev-cross-plat/performance/script-authoring-considerations?ref=arabroot.io)، أما `List` فتضيف العنصر في مكانه.
- **الدالة `Test-Trigger`** هي المكان الوحيد الذي نقرأ فيه نصاً، وتبحث عن عبارة ثابتة فقط. وفي `Get-WinEvent` استخدمنا `-FilterHashtable` بدل أن نجلب السجل كله ونصفيه بـ `Where-Object`، وهذه قاعدة Filter Left نفسها، فالتصفية تحدث داخل خدمة السجلات في Windows، ولا يصل إلى PowerShell إلا الأحداث المطلوبة: المستوى 1 حرج Critical والمستوى 2 خطأ Error، في آخر 24 ساعة.
- **الملفان يكتبان بـ `-Encoding UTF8`** و`-NoTypeInformation` و`-Depth $JsonDepth`، أي كل ما تعلمناه في قسم التصدير، حتى يخرج الملف نفسه من 5.1 ومن 7.

شغلنا السكربت على جهاز المختبر باسم PC-01 بدل اسم الجهاز الحقيقي، والمخرج سوف يكون كما يلي:

```text
PC-01  Microsoft Windows 11 Pro build 26100  up 7.4 days  RAM free 36.4%
disk C: 24.3 GB free of 930.4 GB (2.6%)
disk D: 30.5 GB free of 447.1 GB (6.8%)
disk F: 525.4 GB free of 1863 GB (28.2%)
disk G: 23 GB free of 930.4 GB (2.5%)
services Automatic but stopped: 4   System errors in 24 h: 37 from 2 sources
issues: 9  ->  reports\issues.csv, reports\report.json
```

وهذا محتوى الملف الذي يصل إلى المدير:

```text
"Machine","Area","Item","Detail","Level"
"PC-01","Disk","C:","2.6% free","Warning"
"PC-01","Disk","D:","6.8% free","Warning"
"PC-01","Disk","G:","2.5% free","Warning"
"PC-01","Service","GoogleUpdaterInternalService157.0.8089.0","Stopped, start type Automatic","Warning"
"PC-01","Service","GoogleUpdaterService157.0.8089.0","Stopped, start type Automatic","Warning"
"PC-01","Service","Intel(R) TPM Provisioning Service","Stopped, start type Automatic","Warning"
"PC-01","Service","MapsBroker","Stopped, start type Automatic","Warning"
"PC-01","EventLog","Schannel","36 errors in 24 h (last id 36874)","Error"
"PC-01","EventLog","googledrivefs31931","1 errors in 24 h (last id 2)","Error"
```

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

- **القرص C فيه 2.6% فقط من المساحة حرة**، أي 24.3 غيغابايت من 930، ومثله القرص G، والقرص D تحت حد 15% أيضاً. وهذه مشكلة حقيقية لأن Windows يحتاج مساحة لملف الصفحات Page File والتحديثات، وهي بالضبط ما أراد المدير أن يعرفه كل صباح قبل أن يتصل به أحد الموظفين.
- **أربع خدمات متوقفة من أصل سبع** بعد أن استثنى السكربت الخدمات التي لها مشغلات. وهذه الأربع تحتاج أن تفحصها بنفسك مرة واحدة: إذا كانت خدمة تحديث لبرنامج يعمل ثم يتوقف بطبيعته فأضفها إلى `-IgnoreServices`، وإذا كانت خدمة يحتاجها الجهاز فهذه مشكلة تحتاج إصلاحاً. والمهم أن هذا القرار يؤخذ مرة واحدة ويكتب في السكربت، لا أن يتجاهل المدير القائمة كل يوم.
- **36 خطأ من المصدر Schannel** في آخر 24 ساعة، كلها برقم الحدث 36874\. وSchannel هو [مكون TLS في Windows](https://learn.microsoft.com/en-us/windows/win32/secauthn/secure-channel?ref=arabroot.io)، أي المكون الذي يتفاوض على الاتصالات المشفرة. والتقرير لا يقول لك ما سبب الخطأ، وإنما يقول لك أين تبحث، والخطوة التالية أن تفتح أحد هذه الأحداث وتقرأ رسالته، وهذا موضوع [مقال سجلات الأحداث](https://arabroot.io/articles/%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%AD%D8%AF%D8%A7%D8%AB-event-viewer-%D9%83%D9%8A%D9%81-%D8%AA%D9%82%D8%B1%D8%A7-%D9%85%D8%A7-%D8%AD%D8%AF%D8%AB-%D9%81%D9%8A-%D8%AC%D9%87%D8%A7%D8%B2%D9%83/) في هذه المرحلة.

أما ملف JSON فيحتوي الصورة الكاملة، ومنها الأقراص كمصفوفة كائنات بأرقام حقيقية لا نصوص. وهذا جزء منه:

```text
{
    "Machine":  "PC-01",
    "CreatedAt":  "2026-11-12T10:28:34",
    "PowerShell":  "5.1.26100.9711",
    "OS":  {
               "Name":  "Microsoft Windows 11 Pro",
               "Build":  "26100",
               "UptimeDays":  7.4,
               "MemoryFreePct":  36.4
           },
    "Disks":  [
                  {
                      "Drive":  "C:",
                      "SizeGB":  930.4,
                      "FreeGB":  24.3,
                      "FreePct":  2.6
                  },
                  {
                      "Drive":  "D:",
                      "SizeGB":  447.1,
                      "FreeGB":  30.5,
                      "FreePct":  6.8
                  },
```

لاحظ أن القيم `SizeGB` و`FreePct` أرقام دون علامات اقتباس، فإذا قرأ نظام المراقبة الملف استطاع أن يقارن `FreePct` برقم مباشرة. ولو كان التقرير أعمق من العمق الذي حددناه لظهرت هنا نصوص مثل `@{...}` كما رأينا في قسم التصدير، ولذلك جعلنا العمق خياراً للسكربت، فإذا أضفت للتقرير مستوى جديداً زدت العمق دون أن تعدل الكود.

📌

هذا السكربت يقرأ جهازاً واحداً هو الجهاز الذي يعمل عليه، وتقرير الأجهزة الثلاثين يحتاج إما أن يعمل السكربت في كل جهاز كمهمة مجدولة ويرسل ملفاته إلى مجلد مشترك، أو أن يقرأ جهاز واحد البقية عن بعد عبر PowerShell Remoting. وكلا الطريقين يحتاج إعداداً وصلاحيات على مستوى الشبكة، وسوف نتناولهما في مقالات قادمة من هذا المسار بإذن الله.

## أخطاء شائعة Common Mistakes

- **قص مخرج الأوامر النصية:** إذا وجدت نفسك تكتب `-split` أو `Substring` على مخرج أمر، فابحث أولاً عن أمر PowerShell يرجع الشيء نفسه ككائن. والاستثناء الوحيد معلومة لا يكشفها أي أمر، مثل مشغلات الخدمات، وعندها ابحث عن عبارة ثابتة ولا تقص أعمدة.
- **`Format-Table` في وسط الأنبوب:** كما رأينا خرج ملف CSV فيه سجلات عرض بدل الخدمات. وأوامر `Format-*` مكانها آخر الأنبوب فقط، ولاختيار الخصائص استخدم `Select-Object`.
- **خطأ إملائي في اسم خاصية:** يعطي `$null` بصمت ونتيجة فارغة، والحل `Set-StrictMode -Version Latest` في أول كل سكربت.
- **`ConvertTo-Json` دون `-Depth`:** يقطع أي بيانات بعد المستوى الثاني ويحولها إلى نص، وفي 5.1 يفعل ذلك دون أي تحذير.
- **الترتيب بعد `Import-Csv`:** كل القيم ترجع نصوصاً، فحولها إلى أرقام قبل أن ترتب أو تقارن.
- **سكربت فيه حروف عربية محفوظ UTF-8 دون BOM:** لا يعمل في 5.1 أو يطبع حروفاً مشوهة، فاحفظه مع BOM.
- **`sc` بدل `sc.exe`:** في Windows PowerShell الاسم `sc` وحده هو `Set-Content`، فالأمر يكتب في ملف بدل أن يسأل عن الخدمة.
- **اعتبار كل خدمة Automatic متوقفة مشكلة:** الخدمات التي لها مشغلات تتوقف بطبيعتها، ووضعها في التقرير يجعل الناس يتجاهلونه.
- **الاعتماد على سياسة التشغيل كحماية:** هي ليست حداً أمنياً، فلا تفتحها للجهاز كله لتشغيل سكربت واحد، ولا تعتمد عليها لمنع أحد من شيء.

## تدريب عملي Practice

1. أضف إلى سكربت التقرير قسماً يقرأ آخر خمسة تحديثات مثبتة بالأمر `Get-HotFix`، ويضيف مشكلة إذا كان آخر تحديث أقدم من ثلاثين يوماً. ابدأ بـ `Get-HotFix | Get-Member` لتعرف اسم خاصية التاريخ ونوعها.
2. شغل `Get-Service | Where-Object Status -eq Running | Measure-Object` ثم اكتب الشيء نفسه بخيار يصفي في `Get-Service` إن وجد، واستخدم `Measure-Command` لتقارن الوقت كما فعلنا في القسم السادس من المختبر.
3. غير `-JsonDepth` إلى 1 وشغل السكربت، ثم افتح `report.json` وانظر ماذا حدث للأقراص. توقع النتيجة قبل أن تشغل.
4. افحص الخدمات الأربع التي ظهرت في تقريرك بالأمر `Get-CimInstance Win32_Service -Filter "Name='اسم الخدمة'" | Select-Object Name, StartMode, DelayedAutoStart, PathName`، وقرر لكل واحدة هل تضيفها إلى `-IgnoreServices` أم تصلحها.
5. إذا كان PowerShell 7 مثبتاً في جهازك، شغل `04-export.ps1` بـ `pwsh` مباشرة وقارن المخرج بما في هذا المقال.

## حذف المختبر Cleanup

```powershell
Remove-Item -Recurse -Force .\out-5, .\out-7, .\reports
docker image rm mcr.microsoft.com/dotnet/sdk:10.0
```

الأمر الأول يحذف الملفات التي كتبتها السكربتات في مجلد المختبر، والثاني يحذف Docker Image الخاصة بـ .NET 10 SDK إذا لم تكن تحتاجها لشيء آخر، وتبقى السكربتات وملفات المخرج `out-*.txt` كما هي.

## الخلاصة Summary

- في Windows تعيش الإعدادات والخدمات والسجلات خلف واجهات برمجية، والنص الذي تطبعه الأدوات رسم للشاشة، ولذلك بنى PowerShell أنبوبه على الكائنات لا على النص.
- قص مخرج `tasklist` أخطأ في الأسماء التي فيها مسافات وفي ترتيب الأرقام التي فيها فواصل، بينما رتب `Get-Process` الذاكرة صحيحاً من أول مرة لأن `WorkingSet64` رقم من نوع `long`.
- `Get-Member` يقول لك ماذا في الكائن، و`Where-Object` يصفي و`Select-Object` يختار و`Sort-Object` يرتب و`Group-Object` يجمع، والتصفية في أول الأنبوب كانت أسرع بعشر مرات.
- `Format-Table` يحول الكائنات إلى سجلات عرض، فضعه في آخر الأنبوب فقط.
- بين 5.1 و7 فروق ستقابلها: سطر `#TYPE` في CSV، وقطع JSON بصمت عند العمق 2، وملفات UTF-16LE من العامل `>`، وسكربتات عربية لا تعمل دون BOM. وكلها لها حل يعمل في النسختين.
- سكربت التقرير الصباحي، دون صلاحيات المدير، وجد في جهاز المختبر قرصين تحت 3% من المساحة الحرة، وأربع خدمات متوقفة تحتاج قراراً، و36 خطأ TLS في يوم واحد.

وفي المقالات القادمة من هذه المرحلة بإذن الله سوف ندخل إلى ما يقرؤه هذا التقرير من الداخل: كيف يعمل Windows ومن أين تأتي العمليات والخدمات، وكيف تقرأ سجلات الأحداث Event Logs وتفهم أخطاء مثل التي وجدناها:

[![](https://arabroot.io/content/images/2026/11/windows-architecture-cover-cover.webp)دليلكيف يعمل Windows من الداخل؟ وضع المستخدم والنواة والخدماتما الذي يعمل تحت سطح مكتب Windows: طبقاته من البرنامج إلى العتاد، ولماذا يغلق البرنامج وحده بينما يوقف التعريف الجهاز كله، ومن يشغل من عند الإقلاع، مع مختبر PowerShell على Windows 11.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-windows-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84-%D9%88%D8%B6%D8%B9-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%AE%D8%AF%D9%85-%D9%88%D8%A7%D9%84%D9%86%D9%88%D8%A7%D8%A9/)[![](https://arabroot.io/content/images/2026/11/windows-services-cover-cover.webp)دليلالخدمات Services في Windows: كيف تعمل وكيف تديرهامن يشغل خدمات Windows ويوقفها، ومتى تبدأ، وبأي حساب تعمل، ومن يعيدها عندما تسقط، وما يكتبه مدير الخدمات في سجل الأحداث، مع مختبر PowerShell يقرأ 318 خدمة بصلاحيات مستخدم عادي.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AE%D8%AF%D9%85%D8%A7%D8%AA-services-%D9%81%D9%8A-windows-%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D9%88%D9%83%D9%8A%D9%81-%D8%AA%D8%AF%D9%8A%D8%B1%D9%87%D8%A7/)[![](https://arabroot.io/content/images/2026/11/windows-event-viewer-cover-cover.webp)دليلسجلات الأحداث Event Viewer: كيف تقرأ ما حدث في جهازككيف تعرف من سجلات Windows لماذا أعاد جهازك التشغيل وحده، من التحديث إلى الشاشة الزرقاء إلى زر الطاقة، بعارض الأحداث وPowerShell دون صلاحيات المسؤول.](https://arabroot.io/articles/%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%AD%D8%AF%D8%A7%D8%AB-event-viewer-%D9%83%D9%8A%D9%81-%D8%AA%D9%82%D8%B1%D8%A7-%D9%85%D8%A7-%D8%AD%D8%AF%D8%AB-%D9%81%D9%8A-%D8%AC%D9%87%D8%A7%D8%B2%D9%83/)[![](https://arabroot.io/content/images/2026/11/shells-compare-cover-cover.webp)دليلالصدفة Shell: Bash أم Zsh أم Fish أم PowerShell؟نفس المهام في Bash وZsh وFish وPowerShell مع زمن البدء وترتيب ملفات الإعداد كما قسناه، حتى تعرف أي Shell يناسب السيرفر وأيها يناسب جهاز التطوير.](https://arabroot.io/articles/%D8%A7%D9%84%D8%B5%D8%AF%D9%81%D8%A9-shell-bash-%D8%A7%D9%85-zsh-%D8%A7%D9%85-fish-%D8%A7%D9%85-powershell/)

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، وتشغيل المختبر على Windows PowerShell 5.1.26100 في Windows 11 Pro (build 26100) بحساب مستخدم عادي، وعلى PowerShell 7.6.10 من Docker Image الخاصة بـ .NET 10 SDK في Docker Engine 29.8.0.