تجنبAssignmentToAutomaticVariable

مستوى الشدة: تحذير

الوصف

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

تجنب استخدام أسماء المتغيرات التلقائية في دوالك ومعاملاتك. احتفظ بالمتغيرات التلقائية للاستخدام الداخلي ل PowerShell فقط، واعتمد عليها فقط لقراءة معلومات الحالة.

لمعرفة المزيد، راجع about_Automatic_Variables.

كيف

استخدم أسماء المتغيرات في الدوال أو معاملاتها التي لا تتعارض مع المتغيرات التلقائية.

مثال

غير متوافق

المتغير $Error هو متغير تلقائي موجود في النطاق العام، وبالتالي لا ينبغي استخدامه كاسم متغير أو معاملات.

function foo($Error){ }
function Get-CustomErrorMessage($ErrorMessage){ $Error = "Error occurred: $ErrorMessage" }

متوافقه

function Get-CustomErrorMessage($ErrorMessage){ $FinalErrorMessage = "Error occurred: $ErrorMessage" }