تدريب - «مرحبًا بالعالم»!

مكتمل

واحدة من أفضل الطرق لتعلم التعليمات البرمجية هو كتابة العديد من البرامج الصغيرة. كتابة برامج أصغر تحصل على أساس أساسيات البرمجة والتقنيات الهامة التي تطبقها عند البدء في كتابة برامج أكبر.

إشعار

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

إشعار

في هذه الوحدة، يمكنك استخدام Azure Cloud Shell كمحطة طرفية. يمكنك الوصول إلى Cloud Shell من خلال مدخل Microsoft Azure أو تسجيل الدخول إلى Cloud Shell. لست مضطرا لتثبيت أي شيء على جهاز الكمبيوتر أو الكمبيوتر المحمول لاستخدامه.

كتابة الأسطر الأولى من التعليمات البرمجية

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

الخطوة 1: اكتب التعليمات البرمجية في Cloud Shell

يوفر Azure Cloud Shell تجربة داخل المستعرض لدعم نهج البرنامج التعليمي الخاص بنا، ويتصرف مثل نافذة PowerShell الطرفية العادية. يمكنك كتابة الأوامر مباشرة في النافذة، أو يمكنك تشغيل البرامج النصية المكتوبة مسبقا والحصول على النتائج في Cloud Shell.

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

  1. افتح Azure Cloud Shell واكتب التعليمات البرمجية التالية:

    New-Item HelloWorld.ps1
    code HelloWorld.ps1
    

    إشعار

    إذا رأيت مربع حوار يسألك عما إذا كنت تريد التبديل إلى Classic Cloud Shell، فحدد Confirm. ثم أعد إدخال الأمر code HelloWorld.ps1 الثاني لفتح الملف في محرر التعليمات البرمجية Cloud Shell.

    New-Item يقوم الأمر بإنشاء ملف جديد .ps1 في الدليل الحالي. .ps1 ملحق اسم الملف هو الملحق المستخدم لنصوص PowerShell النصية.

    يفتح code الأمر متبوعا باسم ملف البرنامج النصي الذي تريد العمل عليه الملف في محرر التعليمات البرمجية Cloud Shell. تفتح نافذة أخرى حيث يمكنك كتابة البرامج النصية وتحريرها ثم حفظها للتشغيل في Cloud Shell. إذا كنت تريد فتح ملف مخزن في موقع آخر، يمكنك تعريف المسار الكامل بدلا من استخدام اسم الملف فقط.

  2. في نافذة محرر التعليمات البرمجية، اكتب التعليمات البرمجية التالي:

    Write-Output 'Hello World!'
    
  3. احفظ الملف باستخدام اختصار لوحة المفاتيح Ctrl+S في Windows (أو +S على macOS).

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

    إشعار

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

الخطوة 2: تشغيل البرنامج النصي

لتشغيل النص البرمجي، أدخل الأمر التالي في محطة Cloud Shell:

. ./HelloWorld.ps1

إشعار

تأكد من تضمين النقطة (.) في بداية الأمر. هذا يخبر PowerShell بتشغيل البرنامج النصي أو الملف الذي يتم استدعاؤه.

الخطوة 3: مراقبة النتيجة

من المفترض أن ترى الناتج التالي في Cloud Shell:

Hello World!

ما الذي يتوجب القيام به في حالة رؤية رسالة خطأ

بينما تتطلب اللغات الأخرى أن يكون كل حرف واضحًا، يكون PowerShell أكثر ارتياحًا. إنها غير حساسة لحالة الأحرف، ما يعني أنها لا تهتم بما إذا كنت تكتب عن طريق الخطأ حرفًا كبيرًا أو صغيرًا حيث لا يُفترض بك ذلك. إنه يفسر Write-Output و write-output بنفس الطريقة. الأشياء الرئيسية التي يجب الانتباه إليها هي الأخطاء الإملائية أو وجود مساحة إضافية أو مفقودة.

في حالة حدوث خطأ، قد يبدو مثل هذا:

Write-Outpu: The term 'Write-Outpu' is not recognized as a name of a cmdlet, function, script file, or executable program. 
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

في هذا المثال، يخبرنا PowerShell أننا كتبنا Write-Outpu بشكل غير صحيح بدلا من Write-Output، ولا يمكنه العثور على الأمر الذي حددناه.

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

إشعار

ليست كل الأخطاء واضحة مثل المثال السابق للقراءة والفهم. قد يستغرق البعض القليل من الاختبار والتحقيق لمعرفة سببها.

الخطوة 4: إنشاء ملف جديد وكتابة التعليمات البرمجية لتلقي الإدخال

  1. في الملف المفتوح HelloWorld.ps1 ، قم بالتعليق على التعليمات البرمجية التي كتبتها في المحرر عن طريق إضافة علامة رقم (#) قبل الأمر. أسفل سطر التعليق، أضف سطور التعليمات البرمجية التالية:

    # Write-Output 'Hello World!'
    
    $name = Read-Host -Prompt "Please enter your name"
    Write-Output "Congratulations $name! You have written your first code with PowerShell!"
    

إشعار

يمكنك إنشاء تعليق التعليمة البرمجية ببدء سطر من النص بعلامة الرقم (#). تساعدك هذه التقنية المفيدة في منع تشغيل تعليمات برمجية معينة دون الحاجة إلى إزالته بالكامل. يمكنك أيضًا استخدام التعليقات لإضافة معلومات لنفسك أو للآخرين الذين قرؤوا التعليمات البرمجية الخاصة بك لاحقًا. يمكنك وضع التعليقات في أي مكان في التعليمات البرمجية الخاصة بك، ويتم التعليق على أي نص بعد # على نفس السطر.

  1. احفظ الملف، ثم قم بتشغيل البرنامج النصي باستخدام نفس الأمر الذي استخدمته سابقًا:

    . ./HelloWorld.ps1
    
  2. في المطالبة التي تطلب اسمك، اكتب اسمك، ثم حدد Enter.

    الإخراج عبارة عن رسالة مع إدراج اسمك. على سبيل المثال:

    Congratulations Chase! You have written your first code with PowerShell!
    

كيف يعمل برنامجك؟

في هذا التمرين، قمت باستدعاء أمر cmdlet يسمى Write-Output. Cmdlets هي الطريقة الرئيسية التي تستخدم بها PowerShell. بناء جملة الأمر هو Verb-Noun تنسيق. يسهل بناء الجملة هذا فهم ما تحاول التعليمات البرمجية القيام به. اسم cmdlet هو الهدف منه. تقوم التعليمات البرمجية بعمل شيء ما (فعل) لشيء (اسم).

Hello World! وجملة التهنئة كلاهما عبارة عن مدخلات سلسلة لـ cmdlet Write-Output للمعالجة والإخراج. السلسلة هي نوع بيانات أساسي تستخدمه أجهزة الكمبيوتر. في PowerShell، يمكنك إحاطة السلاسل إما بعلامات اقتباس مفردة ('') أو علامات اقتباس مزدوجة (""). بالنسبة للتعليمات البرمجية الخاصة بنا، نستخدم علامات اقتباس مزدوجة للسماح ل PowerShell بعرض قيم متغيرة بدلا من أسماء المتغيرات. يمكنك معرفة المزيد حول أنواع البيانات وكيفية تعريفها في وحدة نمطية لاحقة.

باستخدام Read-Host، يمكنك كتابة رسالة لمطالبة المستخدم بإدخالها. يمكنك تعريف الرسالة للمستخدم باستخدام المعلمة -Prompt . تسمح المعلمات لأمر cmdlet بأخذ مدخلات من المستخدم. تقوم بتخزين الإدخال في متغير يسمى $name، ثم تستخدم cmdlet Write-Output لعرض الرسالة المخصصة في محطة Cloud Shell.

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

يمكنك تعريف متغير عن طريق وضع علامة الدولار ($) في بداية الكلمة. بعد الكلمة، استخدم علامة التساوي (=) متبوعة بالقيمة التي تريد تخزينها في المتغير. في المثال السابق، قمت بتخزين الاسم "Chase." يمكن تسمية المتغيرات بأي شيء، ولكن من الأفضل تسميتها بشيء يساعدك على فهم ما تخزنه ومكان استخدامه. على سبيل المثال، $name يقوم بتخزين الاسم الأول لشخص ما.

تعمل العديد من أوامر cmdlets مثل المثال السابق. يقوم المستخدم بتوفير إدخال إلى الأمر cmdlet، ويقوم الأمر cmdlet بعمل شيء ما، ثم يقوم الأمر cmdlet بإنتاج مخرجات. يمكن أن تكون هذه العملية شيئًا مثل الكتابة في جزء الإخراج، أو حساب معادلة، أو تغيير شيء ما في البيئة، أو أشياء أخرى كثيرة.

خلاصة

لنأخذ لحظة لخلاصة ما تعلمته في هذه الوحدة الأولى:

  • Cmdlets هي الطريقة الرئيسية للتفاعل مع PowerShell. تتم كتابتها Verb-Noun بتنسيق.
  • المعلمات تأخذ الإدخال بحيث يمكن أن يوفر أمر cmdlet الإخراج أو يتخذ إجراء.
  • PowerShell هي لغة مريحة. أي أنها غير حساسة لحالة الأحرف بشكل افتراضي.
  • يمكن أن تساعدك أخطاء PowerShell في تحديد المشكلات، ويمكن أن توفر لك قراءة الأخطاء بعناية الوقت.
  • يتم استخدام المتغيرات لتخزين القيم التي تريد استخدامها بشكل حيوي في البرامج الخاصة بك.