参数集,即是powershell的语法,
可使用其中的一个参数集,各参数集的参数不能混用,若各参数集有公有参数,运行时只指定一个公有参数时,默认运行第一个含有该参数的参数集。如Get-EventLog 有2个参数集,其中-ComputerName是共有参数。
可选和必选参数:
可选参数放在一个方括号中。例如,[[-ComputerName] <String[]>] 表示整个-ComputerName参数是可选的。
必选参数不在方括号中,例如,[-LogName] <String>
位置参数:
两种方式用于确定位置参数:通过语法概要或者通过详细的帮助文档。
位置参数 可以不用指定参数名,根据位置输入参数值即可
在语法概要中找到位置参数,
只有参数名被方括号括起来的参数。比如,[-LogName] <String>
在详细的帮助文档中找到位置参数,
Get-Help Get-EventLog -Full 查看-LogName是一个强制参数,并且其位置为0,所以是位置函数。
如果不使用-Full参数,可以尝试使用-ShowWindow参数,该参数可以在客户端版本的Windows或带有GUI的Server版本的Winodws上执行。-ShowWindows参数无法在非Windows OS中使用。
参数值:
帮助文档也提供了每个参数的数据类型。
有些参数被称为开关参数,无需任何输入值。例如:[-AsString],在详细语法中,看起来如下所示:
-AsString [<SwitchParameter>],通过[<SwitchParameter>]可以确认这是一个开关参数,并不需要任何输入值。
其他参数值的数据类型,通常会跟在参数名称之后,并使用空格与参数名称分开。例如:[-LogName] <String>
通常的的参数值类型:String,Int/Int32/Int64,DateTime
有些值包含多个方括号:
[-ComputerName <String []>]
String后面的括号意味着可以 接受数组,集合,或者一个列表类型的字符串。只提供一个值也符合语法。
Get-EventLog Security -computer Server01,Server02,Server03
Get-EventLog Security -computer 'Server01','Server02','Server03'
或
可以把server01,server02,server03放在names.txt中,
Get-EventLog Application -computer (Get-Content names.txt)
通用参数:
Help *common* 找到About_common_parameters 该主题会显示出11个通用参数
about开头的文档即是帮助文档,运行help about*列出所有帮助信息,所有的命令都有对应的帮助文档。
更新在线帮助 Update-Help -Force,下载本地帮助文档。
还有在线帮助文档,参数指定online即可:Help Get-EventLog -online
微软的TechNet站点运维该在线文档帮助,通常比安装PowerShell中的帮助文档要更新。但是在线文档不会包含所有Cmdlet的帮助信息,由各个产品团队负责共同提供帮助文档的更新(如Exchange团队,SQL团队,SharePoint团队等),如果在线文档可用的话,一般是内置帮助文档的补充。也可以使用-ShowWindow开关参数打开在线文档。