New-Object 帮助信息

[align=left]如下说明是翻译PowerShell中: help New-Object 产生的帮助信息. [/align]
[align=left]译者: Edengundam(马涛)[/align]

[align=left]New-Object[/align]
[align=left] [/align]
[align=left]大纲[/align]
[align=left]创建一个.Net或COM对象的实例.[/align]
[align=left] [/align]
[align=left]语法[/align]
[align=left]New-Object [-typeName] <string> [[-argumentList] <Object[]>] [<CommonParameters>][/align]
[align=left] [/align]
[align=left]New-Object [-comObject] <string> [-strict] [<CommonParameters>][/align]
[align=left] [/align]
[align=left]详细描述[/align]
[align=left]创建一个.Net或COM对象的实例. 你指定.Net类的类型或一个COM对象的Programmatic Identifier(ProgID). 默认情况下, 你键入.Net的完全限定名, cmdlet返回该类实例的一个引用. 要创建一个COM对象的实例, 使用ComObject参数并将对象的ProgID作为参数值.[/align]
[align=left] [/align]
[align=left]参数[/align]
[align=left] [/align]
[align=left]-typeName <string>[/align]
[align=left]指定.Net类的完全限定名. 你不能同时指定TypeName参数和ComObject参数.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]true[/align]
[align=left]参数位置?[/align]	[align=left]1[/align]
[align=left]默认值[/align]	[align=left] [/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]-argumentList <Object[]>[/align]
[align=left]为.Net类的构造器指定参数列表. 使用逗号(,)隔离列表中的元素.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]2[/align]
[align=left]默认值[/align]	[align=left] [/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]-comObject <string>[/align]
[align=left]COM对象的Programmatic Identifier (ProgID).[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]true[/align]
[align=left]参数位置?[/align]	[align=left]1[/align]
[align=left]默认值[/align]	[align=left] [/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]-strict <SwitchParameter>[/align]
[align=left]指定如果你试图创建的COM对象使用了互操作程序集, 应该给出错误. 这使得您能够区分实际的COM对象和COM可调用包装的.Net对象.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]named[/align]
[align=left]默认值[/align]	[align=left]false[/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]<公共参数>[/align]
[align=left]此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".[/align]
[align=left] [/align]
[align=left]返回类型[/align]
[align=left]Object[/align]
[align=left] [/align]
[align=left]注意[/align]
[align=left] [/align]
[align=left]New-Object提供了VBScript中最频繁使用的CreateObject函数的功能. 在VBScript中类似语句Set objShell = CreateObject("Shell.Application")可以被转化为Windows PowerShell 中的$objShell = new-object -comobject "Shell.Application".[/align]
[align=left] [/align]
[align=left]New-Object允许您在命令行和脚本中更容易的使用.Net对象, 从而扩展了Windows Script Host环境的可用性.[/align]
[align=left] [/align]
[align=left]更多信息, 输入"Get-Help New-Object -detailed".需要技术信息, 输入"Get-Help New-Object -full".[/align]
[align=left] [/align]
[align=left]如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".[/align]
[align=left] [/align]
[align=left]例1 [/align]
[align=left] [/align]
[align=left]C:/PS>$ver = new-object -typename System.Version -argumentlist "1.2.3.4" [/align]
[align=left]$ver | get-member[/align]
[align=left] [/align]
[align=left]此命令创建了一个类型为System.Version的.Net对象, 使用字符串"1.2.3.4"作为构造方法的参数. 它将该对象的引用保存在$ver变量中, 并将其通过管道发送给Get-Member cmdlet来显示该引用对象的属性和方法.[/align]
[align=left] [/align]
[align=left]例2 [/align]
[align=left] [/align]
[align=left]C:/PS>$ie = new-object -comobject InternetExplorer.Application [/align]
[align=left]$ie.navigate2("www.microsoft.com")[/align]
[align=left]$ie.visible = $true[/align]
[align=left] [/align]
[align=left]此命令创建一个COM对象的实例用来表示Internet Explorer应用程序. 它是用对象来浏览网站, 接下来设置可见性属性为$true使得应用程序可见.[/align]
[align=left] [/align]
[align=left]例3 [/align]
[align=left] [/align]
[align=left]C:/PS>$a=new-object -comobject Word.Application -strict [/align]
[align=left]$a.visible=$true[/align]
[align=left] [/align]
[align=left]此命令展示了指定Strict参数, 当创建COM对象使用了互操作程序集, 将会引起new-object生成非终止错误.[/align]
[align=left] [/align]
[align=left]New-Object : 被输入到管道中的对象是来自主要互操作程序集中的组件"Microsoft.Office.Interop.Word.ApplicationClass"类型的实例. 如果这个类型提供了与Idispatch成员不同的成员, 主要互操作程序集没有安装, 此对象进行交互的脚本可能不能工作.[/align]
[align=left] [/align]
[align=left]At line:1 char:14[/align]
[align=left]+ $a=New-Object <<<< -COM Word.Application -Strict; $a.visible=$true[/align]
[align=left] [/align]
[align=left]例4 [/align]
[align=left] [/align]
[align=left]C:/PS>$objshell = new-object -comobject "Shell.Application"[/align]
[align=left]$objshell | get-member[/align]
[align=left]$objshell.ToggleDesktop()[/align]
[align=left] [/align]
[align=left]命令使用ComObject参数创建ProgID为"Shell.Application"的COM对象. 他将引用到对象的结果存储在$objShell变量中, 并将此变量通过管道发送给Get-Member cmdlet. Get-Member cmdlet显示COM对象的属性和方法. 最后一行, 对象的ToggleDesktop方法被调用. 他将最小化所有在你的桌面上打开的窗口.[/align]
[align=left] [/align]
[align=left]相关链接[/align]
[align=left]Compare-Object[/align]
[align=left]Select-Object[/align]
[align=left]Sort-Object[/align]
[align=left]ForEach-Object[/align]
[align=left]Group-Object[/align]
[align=left]Measure-Object[/align]
[align=left]Tee-Object[/align]
[align=left]Where-Object[/align]