New-Object

구문

New-Object
   [-TypeName] <String>
   [[-ArgumentList] <Object[]>]
   [-Property <IDictionary>]
   [<CommonParameters>]

New-Object
   [-ComObject] <String>
   [-Strict]
   [-Property <IDictionary>]
   [<CommonParameters>]

Description

cmdlet은 New-Object .NET Framework 또는 COM 개체의 인스턴스를 만듭니다.

.NET Framework 클래스의 형식 또는 COM 개체의 ProgID를 지정할 수 있습니다. 기본적으로 .NET Framework 클래스의 정규화된 이름을 입력하고 cmdlet은 해당 클래스의 인스턴스에 대한 참조를 반환합니다. COM 개체의 인스턴스를 만들려면 ComObject 매개 변수를 사용하고 개체의 ProgID를 해당 값으로 지정합니다.

예제

예제 1: System.Version 개체 만들기

다음은 "1.2.3.4" 문자열을 생성자로 사용하여 System.Version 개체를 만드는 예제입니다.

New-Object -TypeName System.Version -ArgumentList "1.2.3.4"

Major  Minor  Build  Revision
-----  -----  -----  --------
1      2      3      4

예제 2: Internet Explorer COM 개체 만들기

이 예제에서는 Internet Explorer 애플리케이션을 나타내는 COM 개체의 두 인스턴스를 만듭니다. 첫 번째 인스턴스는 Property 매개 변수 해시 테이블을 사용하여 Navigate2 메서드를 호출하고 개체의 Visible 속성을 설정하여 애플리케이션을 표시합니다$True. 두 번째 인스턴스는 개별 명령을 사용하여 동일한 결과를 가져옵니다.

$IE1 = New-Object -COMObject InternetExplorer.Application -Property @{Navigate2="www.microsoft.com"; Visible = $True}

# The following command gets the same results as the example above.
$IE2 = New-Object -COMObject InternetExplorer.Application`
$IE2.Navigate2("www.microsoft.com")`
$IE2.Visible = $True`

예제 3: Strict 매개 변수를 사용하여 종료하지 않는 오류 생성

이 예제에서는 Strict 매개 변수를 추가하면 New-Object COM 개체가 interop 어셈블리를 사용할 때 cmdlet이 종료하지 않는 오류를 생성하는 것을 보여 줍니다.

$A = New-Object -COMObject Word.Application -Strict -Property @{Visible = $True}

New-Object : The object written to the pipeline is an instance of the type
"Microsoft.Office.Interop.Word.ApplicationClass" from the component's primary interop assembly. If
this type exposes different members than the IDispatch members, scripts written to work with this
object might not work if the primary interop assembly is not installed.

At line:1 char:14
+ $A = New-Object  <<<< -COM Word.Application -Strict; $a.visible=$true

예제 4: Windows 데스크톱을 관리하는 COM 개체 만들기

이 예제에서는 COM 개체를 만들고 사용하여 Windows 바탕 화면을 관리하는 방법을 보여 줍니다.

첫 번째 명령은 cmdlet의 New-Object ComObject 매개 변수를 사용하여 Shell.Application ProgID를 사용하여 COM 개체를 만듭니다. 결과 개체를 변수에 $ObjShell 저장합니다. 두 번째 명령은 변수를 $ObjShell cmdlet으로 Get-Member 파이프하여 COM 개체의 속성과 메서드를 표시합니다. 메서드 중에는 ToggleDesktop 메서드가 있습니다. 세 번째 명령은 개체의 ToggleDesktop 메서드를 호출하여 바탕 화면에서 열린 창을 최소화합니다.

$Objshell = New-Object -COMObject "Shell.Application"
$objshell | Get-Member
$objshell.ToggleDesktop()

TypeName: System.__ComObject#{866738b9-6cf2-4de8-8767-f794ebe74f4e}

Name                 MemberType Definition
----                 ---------- ----------
AddToRecent          Method     void AddToRecent (Variant, string)
BrowseForFolder      Method     Folder BrowseForFolder (int, string, int, Variant)
CanStartStopService  Method     Variant CanStartStopService (string)
CascadeWindows       Method     void CascadeWindows ()
ControlPanelItem     Method     void ControlPanelItem (string)
EjectPC              Method     void EjectPC ()
Explore              Method     void Explore (Variant)
ExplorerPolicy       Method     Variant ExplorerPolicy (string)
FileRun              Method     void FileRun ()
FindComputer         Method     void FindComputer ()
FindFiles            Method     void FindFiles ()
FindPrinter          Method     void FindPrinter (string, string, string)
GetSetting           Method     bool GetSetting (int)
GetSystemInformation Method     Variant GetSystemInformation (string)
Help                 Method     void Help ()
IsRestricted         Method     int IsRestricted (string, string)
IsServiceRunning     Method     Variant IsServiceRunning (string)
MinimizeAll          Method     void MinimizeAll ()
NameSpace            Method     Folder NameSpace (Variant)
Open                 Method     void Open (Variant)
RefreshMenu          Method     void RefreshMenu ()
ServiceStart         Method     Variant ServiceStart (string, Variant)
ServiceStop          Method     Variant ServiceStop (string, Variant)
SetTime              Method     void SetTime ()
ShellExecute         Method     void ShellExecute (string, Variant, Variant, Variant, Variant)
ShowBrowserBar       Method     Variant ShowBrowserBar (string, Variant)
ShutdownWindows      Method     void ShutdownWindows ()
Suspend              Method     void Suspend ()
TileHorizontally     Method     void TileHorizontally ()
TileVertically       Method     void TileVertically ()
ToggleDesktop        Method     void ToggleDesktop ()
TrayProperties       Method     void TrayProperties ()
UndoMinimizeALL      Method     void UndoMinimizeALL ()
Windows              Method     IDispatch Windows ()
WindowsSecurity      Method     void WindowsSecurity ()
WindowSwitcher       Method     void WindowSwitcher ()
Application          Property   IDispatch Application () {get}
Parent               Property   IDispatch Parent () {get}

예제 5: 생성자에 여러 인수 전달

이 예제에서는 여러 매개 변수를 사용하는 생성자를 사용하여 개체를 만드는 방법을 보여줍니다. ArgumentList 매개 변수를 사용할 때는 매개 변수를 배열에 넣어야 합니다.

$array = @('One', 'Two', 'Three')
$parameters = @{
    TypeName = 'System.Collections.Generic.HashSet[string]'
    ArgumentList = ([string[]]$array, [System.StringComparer]::OrdinalIgnoreCase)
}
$set = New-Object @parameters

PowerShell은 배열의 각 멤버를 생성자의 매개 변수에 바인딩합니다.

예제 6: 배열을 단일 매개 변수로 사용하는 생성자 호출

이 예제에서는 배열 또는 컬렉션인 매개 변수를 사용하는 생성자를 사용하여 개체를 만드는 방법을 보여줍니다. 배열 매개 변수는 다른 배열 내부에 래핑되어야 합니다.

$array = @('One', 'Two', 'Three')
# This command throws an exception.
$set = New-Object -TypeName 'System.Collections.Generic.HashSet[string]' -ArgumentList $array
# This command succeeds.
$set = New-Object -TypeName 'System.Collections.Generic.HashSet[string]' -ArgumentList (,[string[]]$array)
$set

New-Object : Cannot find an overload for "HashSet`1" and the argument count: "3".
At line:1 char:8
+ $set = New-Object -TypeName 'System.Collections.Generic.HashSet[strin ...
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : InvalidOperation: (:) [New-Object], MethodException
+ FullyQualifiedErrorId : ConstructorInvokedThrowException,Microsoft.PowerShell.Commands.NewObjectCommand

One
Two
Three

이 예제에서 개체를 만드는 첫 번째 시도가 실패합니다. PowerShell은 생성자의 매개 변수에 세 멤버를 $array 바인딩하려고 했지만 생성자는 세 개의 매개 변수를 사용하지 않습니다. 다른 배열을 래핑 $array 하면 PowerShell에서 생성자의 매개 변수에 세 멤버 $array 를 바인딩하려고 시도하지 않습니다.

매개 변수

-ArgumentList

-ComObject

-Property

-Strict

-TypeName

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

Object

이 cmdlet은 만든 개체를 반환합니다.

참고

• New-Object 는 VBScript CreateObject 함수의 가장 일반적으로 사용되는 기능을 제공합니다. VBScript와 같은 Set objShell = CreateObject("Shell.Application") 문은 PowerShell에서 변환 $objShell = New-Object -COMObject "Shell.Application" 할 수 있습니다.
• New-Object 는 명령줄 및 스크립트 내에서 .NET Framework 개체를 쉽게 사용할 수 있도록 하여 Windows 스크립트 호스트 환경에서 사용할 수 있는 기능을 확장합니다.

관련 링크

• about_Object_Creation
• Compare-Object
• Group-Object
• Measure-Object
• Select-Object
• Sort-Object
• Tee-Object