PowerShell編程中的一些命名規(guī)則參考
本文介紹PowerShell自定義函數(shù)在使用時的最佳實(shí)踐(Best Practices)。包括函數(shù)名的命名、可選參數(shù)、必選參數(shù)等。
PowerShell中的函數(shù)定義可以很簡單的使用一個“function <函數(shù)名>{函數(shù)體}”的形式去定義。但微軟推薦創(chuàng)建函數(shù)時遵循以下實(shí)踐規(guī)則。
1、函數(shù)名。
使用cmdlet的統(tǒng)一命令規(guī)則,即“動詞-名詞”的形式。如Write-Host,表示輸出到主機(jī)。如果是獲取一個列表,不要使用List作為動詞,建議使用Get,如Get-ChildItem。名詞部分用一個有意義的英文單詞,記得使用單數(shù),不要使用名詞的復(fù)數(shù)形式。如果要列出網(wǎng)卡的一個函數(shù),不要使用ListNetworkCards,而應(yīng)該使用Get-NetworkCard。這就是關(guān)于函數(shù)命名的最佳實(shí)踐。
2、公司前綴。
假定你寫一個Get-NetworkCard的函數(shù),洪哥也寫了同樣一個。那是不是很難區(qū)分誰是誰寫的?所以,微軟建議在函數(shù)名的名詞部分加上公司前綴,而不加公司前綴的函數(shù),我們一般可以理解為微軟發(fā)布的。這個公司前綴用編寫的兩到三個字母為宜,比如洪哥函數(shù)名可以命為Get-HGNetworkCard。這里洪哥的前綴用的HG,你的呢?
3、參數(shù)的命名要規(guī)范
參數(shù)要用有意義單詞,不要使用-PC作為參數(shù)名,你可以用-ComputerName取而代之。如果有時候需要一個文件路徑作為一個參數(shù),不要使用-File,因?yàn)橹复鷮?shí)在是太模糊了??梢允褂?Path,這樣更明確。雖然沒有官方給出一個標(biāo)準(zhǔn)的參數(shù)命名的列表,但我們應(yīng)該參照內(nèi)置(built-in)的cmdlets所用的那些參數(shù)名稱。這樣其他人使用時才更容易理解,對不對?
4、可選參數(shù)
為可選參數(shù)定義一個默認(rèn)值,這是一個很好的習(xí)慣。如果用戶不管這個參數(shù),那么這個參數(shù)也可以被處于已賦值狀態(tài)。
5、必選參數(shù)
雖然PowerShell中不要求定義函數(shù)參數(shù)時必須指定數(shù)據(jù)類型,但最佳實(shí)踐要求我們這樣做。如果我們指定了類型,那么用戶的輸入將被強(qiáng)制轉(zhuǎn)換為我們定義的數(shù)據(jù)類型,否則都會被當(dāng)作字符串來對待。
6、寫一些注釋來作為幫助說明
一個段函數(shù)給其他人,沒有注釋說明,別人很難看懂。即便是自己,不加注釋的代碼,時間過得久了,也不一定保證能看得懂,對不?
關(guān)于PowerShell函數(shù)使用的最佳實(shí)踐(Best Practices),本文就介紹這么多,希望對您有所幫助,謝謝!
- 利用shell編程實(shí)現(xiàn)DOS風(fēng)格的Linux命令行
- Shell編程的一些知識集合
- shell編程基礎(chǔ) 單引號和雙引號的區(qū)別
- 深入淺出Shell編程 Shell變量介紹
- 分享shell編程中的幾個小技巧
- shell編程基礎(chǔ)知識小結(jié)
- shift妙用之解決shell編程中的入?yún)栴}
- shell編程基礎(chǔ)之認(rèn)識與學(xué)習(xí)BASH
- Shell編程之Shell變量學(xué)習(xí)總結(jié)
- shell編程之實(shí)現(xiàn)windows回收站功能分享
- 讓代碼整潔、過程清晰的BASH Shell編程技巧
- Shell編程指南
相關(guān)文章
PowerShell腳本實(shí)現(xiàn)添加、修改任務(wù)計劃的例子
這篇文章主要介紹了PowerShell腳本實(shí)現(xiàn)添加、修改任務(wù)計劃的例子,PowerShell操作、設(shè)置任務(wù)計劃實(shí)例,需要的朋友可以參考下2014-08-08PowerShell中使用正則表達(dá)式匹配字符串實(shí)例
這篇文章主要介紹了PowerShell中使用正則表達(dá)式匹配字符串實(shí)例,主要介紹match操作符的使用,需要的朋友可以參考下2014-07-07PowerShell腳本開發(fā)之收發(fā)UDP消息包
上篇文章我們介紹了使用PowerShell收發(fā)TCP消息包,今天我們來介紹下使用Powershell收發(fā)UDP小細(xì)胞的方法2014-10-10Powershell小技巧之使用WMI測試服務(wù)響應(yīng)
這篇文章主要介紹了Powershell小技巧之使用WMI測試服務(wù)響應(yīng),需要的朋友可以參考下2014-09-09PowerShell獲取Windows用戶列表、用戶信息的方法
這篇文章主要介紹了PowerShell獲取Windows用戶列表、用戶信息的方法,一個簡單的入門例子,需要的朋友可以參考下2014-08-08PowerShell中執(zhí)行Javascript的方法示例
這篇文章主要介紹了PowerShell中執(zhí)行Javascript的方法示例,特殊場景下可能會用到這個技巧,需要的朋友可以參考下2014-07-07