New-Object 帮助信息

如下说明是翻译PowerShell中: help New-Object 产生的帮助信息.

译者: Edengundam(马涛)

 

New-Object

 

大纲

创建一个.Net或COM对象的实例.

 

语法

New-Object [-typeName] <string> [[-argumentList] <Object[]>] [<CommonParameters>]

 

New-Object [-comObject] <string> [-strict] [<CommonParameters>]

 

详细描述

创建一个.Net或COM对象的实例. 你指定.Net类的类型或一个COM对象的Programmatic Identifier(ProgID). 默认情况下, 你键入.Net的完全限定名, cmdlet返回该类实例的一个引用. 要创建一个COM对象的实例, 使用ComObject参数并将对象的ProgID作为参数值.

 

参数

 

-typeName <string>

指定.Net类的完全限定名. 你不能同时指定TypeName参数和ComObject参数.

 

强制参数?

true

参数位置?

1

默认值

 

允许从管道绑定输入?

false

允许通配符扩展?

false

 

-argumentList <Object[]>

为.Net类的构造器指定参数列表. 使用逗号(,)隔离列表中的元素.

 

强制参数?

false

参数位置?

2

默认值

 

允许从管道绑定输入?

false

允许通配符扩展?

false

 

-comObject <string>

COM对象的Programmatic Identifier (ProgID).

 

强制参数?

true

参数位置?

1

默认值

 

允许从管道绑定输入?

false

允许通配符扩展?

false

 

-strict <SwitchParameter>

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

 

强制参数?

false

参数位置?

named

默认值

false

允许从管道绑定输入?

false

允许通配符扩展?

false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

返回类型

Object

 

注意

 

New-Object提供了VBScript中最频繁使用的CreateObject函数的功能. 在VBScript中类似语句Set objShell = CreateObject("Shell.Application")可以被转化为Windows PowerShell 中的$objShell = new-object -comobject "Shell.Application".

 

New-Object允许您在命令行和脚本中更容易的使用.Net对象, 从而扩展了Windows Script Host环境的可用性.

 

更多信息, 输入"Get-Help New-Object  -detailed".需要技术信息, 输入"Get-Help New-Object -full".

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

例1

 

C:/PS>$ver = new-object -typename System.Version -argumentlist "1.2.3.4"

$ver | get-member

 

此命令创建了一个类型为System.Version的.Net对象, 使用字符串"1.2.3.4"作为构造方法的参数. 它将该对象的引用保存在$ver变量中, 并将其通过管道发送给Get-Member cmdlet来显示该引用对象的属性和方法.

 

例2

 

C:/PS>$ie = new-object -comobject InternetExplorer.Application

$ie.navigate2("www.microsoft.com")

$ie.visible = $true

 

此命令创建一个COM对象的实例用来表示Internet Explorer应用程序. 它是用对象来浏览网站, 接下来设置可见性属性为$true使得应用程序可见.

 

例3

 

C:/PS>$a=new-object -comobject Word.Application -strict

$a.visible=$true

 

此命令展示了指定Strict参数, 当创建COM对象使用了互操作程序集, 将会引起new-object生成非终止错误.

 

New-Object : 被输入到管道中的对象是来自主要互操作程序集中的组件"Microsoft.Office.Interop.Word.ApplicationClass"类型的实例. 如果这个类型提供了与Idispatch成员不同的成员, 主要互操作程序集没有安装, 此对象进行交互的脚本可能不能工作.

 

At line:1 char:14

+ $a=New-Object  <<<< -COM Word.Application -Strict; $a.visible=$true

 

例4

 

C:/PS>$objshell = new-object -comobject "Shell.Application"

$objshell | get-member

$objshell.ToggleDesktop()

 

命令使用ComObject参数创建ProgID为"Shell.Application"的COM对象. 他将引用到对象的结果存储在$objShell变量中, 并将此变量通过管道发送给Get-Member cmdlet. Get-Member cmdlet显示COM对象的属性和方法. 最后一行, 对象的ToggleDesktop方法被调用. 他将最小化所有在你的桌面上打开的窗口.

 

相关链接

Compare-Object

Select-Object

Sort-Object

ForEach-Object

Group-Object

Measure-Object

Tee-Object

Where-Object