[PowerShell]官方文件指令介紹(二)

看官方說明文件有幾點需要先了解

在官方文件查詢命令時,往往會看到如下方形式的介紹:

New-Alias [-Name] <string> [-Value] <string> [-Description <string>]
[-Force] [-Option {None | ReadOnly | Constant | Private | AllScope}]
[-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

看起來很複雜,但事實上不難,只需要記住幾個規則(請看參考資料about_Command_Syntax)。
接下來用New-Alias作範例,分區塊解釋。

範例1: [-Name]代表可寫可不寫,<string>一定要寫
<>:代表參數值和其屬性,<string>代表參數值為字串
[ ]:被中括號包覆表示是選擇性,以New-Alias的參數為例
註: 省略選擇性參數名稱時,命令中的參數順序要注意,因為PowerShell 會依位置和類型將值指派給參數

New-Alias [-Name] <string> [-Value] <string>
EX:
New-Alias -Name utd -Value Update-TypeData
New-Alias utd Update-TypeData

範例2: [-Description <string>] 代表參數-Description和參數值<string>是選擇性的

New-Alias [-Name] <string> [-Value] <string> [-Description <string>]
EX:
New-Alias -Name utd -Value Update-TypeData
New-Alias -Name utd -Value Update-TypeData -Description spec

範例3: 不需要輸入參數值的參數

New-Alias [-Name] <string> [-Value] <string> [-Confirm] [-WhatIf]
EX:
New-Alias -Name utd -Value Update-TypeData -Confirm -WhatIf
New-Alias -Name utd -Value Update-TypeData -WhatIf
New-Alias -Name utd -Value Update-TypeData -Confirm

範例4: 多字串參數值

Get-Process [-Name] <string[]>

EX:
Get-Process -Name Explorer, Winlogon, Services

範例5: 列舉
{}:列舉參數值,代表參數值只能輸入{}內列舉的值,複數值用 | 區隔 

New-Alias [-Name] <string> [-Value] <string> [-Option {None | ReadOnly | Constant | Private | AllScope}]
EX:
New-Alias -Name utd -Value Update-TypeData -Option ReadOnly 
New-Alias -Name utd -Value Update-TypeData -Option Private

範例6: 參數集,同一個命令可能會有不同參數集,代表不同功用,不同參數集之間的命令不能混用
透過使用參數集的參數來區別所用的參數集

//參數集1 用於傳回亂數字
Get-Random [[-Maximum] <Object>] [-Minimum <Object>] [-SetSeed <int>]
[<CommonParameters>]

//參數集2 從一組物件傳回隨機選取的物件
Get-Random [-InputObject] <Object[]> [-Count <int>] [-SetSeed <int>]
[<CommonParameters>]
EX:
//代表使用參數集1
Get-Random -Maximum 100

範例7: 如果沒輸入任何參數,命令會呼叫預設參數集

EX:
Get-Random
>> 1203671478

參考資料:
about_Command_Syntax

相關文章:
[PowerShell]基本介紹(一)
[PowerShell][Windows Server]使用PowerShell遠端連線Windows Server 2019並下指令
[PowerShell][IIS]透過指令方式調整機碼,以開啟遠端管理作為範例
[PowerShell][JSON][Http] 透過PowerShell監控服務運行狀態

嘗試以自己的角度來整理並紀錄,也許會對一些人有幫助。

文章有錯、參考聯結有漏或是連結失效..等,還請幫忙告知,謝謝。
另外參考資料中有很多更棒的文章,建議多看看。