Add-Type

Add-Type -AssemblyName <string[]> [-IgnoreWarnings] [-PassThru] [<CommonParameters>]

Add-Type [-Name] <string> [-MemberDefinition] <string[]> [-CodeDomProvider <CodeDomProvider>] [-CompilerParameters <CompilerParameters>] [-언어 {<CSharp> | <CSharpVersion3> | <VisualBasic> | <JScript>}] [-Namespace <string>] [-OutputAssembly <string>] [-OutputType <OutputAssemblyType>] [-ReferencedAssemblies <string[]>] [-UsingNamespace <string[]>] [-IgnoreWarnings] [-PassThru] [<CommonParameters>]

Add-Type [-Path] <string[]> [-CompilerParameters <CompilerParameters>] [-OutputAssembly <string>] [-OutputType <OutputAssemblyType>] [-ReferencedAssemblies <string[]>] [-IgnoreWarnings] [-PassThru] [<CommonParameters>]

Add-Type [-TypeDefinition] <string> [-CodeDomProvider <CodeDomProvider>] [-CompilerParameters <CompilerParameters>] [-언어 {<CSharp> | <CSharpVersion3> | <VisualBasic> | <JScript>}] [-OutputAssembly <string>] [-OutputType <OutputAssemblyType>] [-ReferencedAssemblies <string[]>] [-IgnoreWarnings] [-PassThru] [<CommonParameters>]

C:\PS>$source = @"
public class BasicTest
{
    public static int Add(int a, int b)
    {
        return (a + b);
    }

    public int Multiply(int a, int b)
    {
        return (a * b);
    }
}
"@

C:\PS> Add-Type -TypeDefinition $source

C:\PS> [BasicTest]::Add(4, 3)

C:\PS> $basicTestObject = New-Object BasicTest 
C:\PS> $basicTestObject.Multiply(5, 2)

설명
-----------
이들 명령은 변수에 저장된 소스 코드를 지정하여 BasicTest 클래스를 세션에 추가합니다. 해당 유형에는 Add라는 정적 메서드와 Multiply라는 비정적 메서드가 포함되어 있습니다.

첫 번째 명령은 클래스의 소스 코드를 $source 변수에 저장합니다.

두 번째 명령은 Add-Type cmdlet을 사용하여 클래스를 세션에 추가합니다. 인라인 소스 코드를 사용하고 있으므로 이 명령은 TypeDefinition 매개 변수를 사용하여 코드를 $source 변수에 지정합니다.

나머지 명령에서는 새 클래스를 사용합니다.

세 번째 명령은 BasicTest 클래스의 Add 정적 메서드를 호출합니다. 이 명령에서는 이중 콜론 문자(::)를 사용하여 클래스의 정적 멤버를 지정합니다.

네 번째 명령은 New-Object cmdlet을 사용하여 BasicTest 클래스의 인스턴스를 인스턴스화한 다음 새 개체를 $basicTestObject 변수에 저장합니다. 

다섯 번째 명령은 $basicTestObject의 Multiply 메서드를 사용합니다.

C:\PS>[BasicTest] | get-member

C:\PS> [BasicTest] | get-member -static

C:\PS> $basicTestObject | get-member

C:\PS> [BasicTest] | get-member


   TypeName: System.RuntimeType

Name                           MemberType Definition
----                           ---------- ----------
Clone                          Method     System.Object Clone()
Equals                         Method     System.Boolean Equals
FindInterfaces                 Method     System.Type[] FindInt
...


C:\PS> [BasicTest] | get-member -static

   TypeName: BasicTest

Name            MemberType Definition
----            ---------- ----------
Add             Method     static System.Int32 Add(Int32 a, Int32 b)
Equals          Method     static System.Boolean Equals(Object objA,
ReferenceEquals Method     static System.Boolean ReferenceEquals(Obj


C:\PS> $basicTestObject | get-member

   TypeName: BasicTest

Name        MemberType Definition
----        ---------- ----------
Equals      Method     System.Boolean Equals(Object obj)
GetHashCode Method     System.Int32 GetHashCode()
GetType     Method     System.Type GetType()
Multiply    Method     System.Int32 Multiply(Int32 a, Int32 b)
ToString    Method     System.String ToString()

설명
-----------
이들 명령은 Get-Member cmdlet을 사용하여 이전 예에서 Add-Type 및 New-Object cmdlet이 만든 개체를 검사합니다.

첫 번째 명령은 Get-Member cmdlet을 사용하여 Add-Type이 세션에 추가한 BasicTest 클래스의 유형 및 멤버를 가져옵니다. Get-Member 명령은 해당 유형이 System.Object 클래스에서 파생된 System.RuntimeType 개체임을 보여 줍니다.

두 번째 명령은 Get-Member의 Static 매개 변수를 사용하여 BasicTest 클래스의 정적 속성 및 메서드를 가져옵니다. 출력에는 Add 메서드가 포함되어 있음이 표시됩니다.

세 번째 명령은 Get-Member를 사용하여 $BasicTestObject 변수에 저장된 개체의 멤버를 가져옵니다. 이 변수는 $BasicType 클래스로 New-Object cmdlet을 사용하여 만든 개체 인스턴스입니다. 

출력에서는 $basicTestObject 변수의 값이 BasicTest 클래스의 인스턴스이고 Multiply라는 멤버를 포함하고 있음을 보여 줍니다.

C:\PS>$accType = add-type -assemblyname accessib* -passthru

설명
-----------
이 명령은 Accessibility 어셈블리의 클래스를 현재 세션에 추가합니다. 이 명령은 AssemblyName 매개 변수를 사용하여 어셈블리의 이름을 지정합니다. 와일드카드 문자를 사용하면 이름이나 철자를 잘 모르는 경우에도 올바른 어셈블리를 가져올 수 있습니다.

이 명령은 PassThru 매개 변수를 사용하여 세션에 추가된 클래스를 나타내는 개체를 생성하고 이 개체를 $accType 변수에 저장합니다.

C:\PS>add-type -path c:\ps-test\Hello.vb

[VBFromFile]::SayHello(", World")

# From Hello.vb
Public Class VBFromFile

Public Shared Function SayHello(sourceName As String) As String
Dim myValue As String = "Hello"

return myValue + sourceName
End Function
End Class

C:\PS> [VBFromFile]::SayHello(", World")
Hello, World

설명
-----------
이 예에서는 Add-Type cmdlet을 사용하여 Hello.vb 파일에 정의된 VBFromFile 클래스를 현재 세션에 추가합니다. Hello.vb 파일의 텍스트가 명령 출력에 표시됩니다.

첫 번째 명령은 Add-Type cmdlet을 사용하여 Hello.vb 파일에 정의된 유형을 현재 세션에 추가합니다. 이 명령은 path 매개 변수를 사용하여 원본 파일을 지정합니다. 

두 번째 명령은 VBFromFile 클래스의 정적 메서드로 SayHello 함수를 호출합니다.

C:\PS>$signature = @"
[DllImport("user32.dll")]
public static extern bool ShowWindowAsync(IntPtr hWnd, int nCmdShow);
"@

$showWindowAsync = Add-Type -memberDefinition $signature -name "Win32ShowWindowAsync" -namespace Win32Functions -passThru

# Minimize the Windows PowerShell console
$showWindowAsync::ShowWindowAsync((Get-Process -id $pid).MainWindowHandle, 2) 

# Restore it
$showWindowAsync::ShowWindowAsync((Get-Process -id $pid).MainWindowHandle, 4)

설명
-----------
이 예의 명령은 Windows PowerShell에서 기본 Windows API를 호출하는 방법을 보여 줍니다. Add-Type은 플랫폼 호출(P/Invoke) 메커니즘을 사용하여 Windows PowerShell에서 User32.dll의 함수를 호출합니다.

첫 번째 명령은 ShowWindowAsync 함수의 C# 시그니처를 $signature 변수에 저장합니다. 자세한 내용은 MSDN 라이브러리(https://go.microsoft.com/fwlink/?LinkId=143643)의 "ShowWindowAsync Function(ShowWindowAsync 함수)"을 참조하십시오. 결과 메서드를 Windows PowerShell 세션에서 볼 수 있도록 표준 시그니처에 "public" 키워드가 추가되었습니다.

두 번째 명령은 Add-Type cmdlet을 사용하여 Add-Type이 만드는 클래스의 정적 메서드로 ShowWindowAsync 함수를 Windows PowerShell 세션에 추가합니다. 이 명령은 MemberDefinition 매개 변수를 사용하여 $signature 변수에 저장된 메서드 정의를 지정합니다.
 
이 명령은 Name 및 Namespace 매개 변수를 사용하여 클래스의 이름 및 네임스페이스를 지정하고, PassThru 매개 변수를 사용하여 유형을 나타내는 개체를 생성한 다음 이 개체를 $showWindowAsync 변수에 저장합니다.

세 번째 및 네 번째 명령은 새 ShowWindowAsync 정적 메서드를 사용합니다. 이 메서드는 창 핸들과 창 표시 방법을 지정하는 정수를 매개 변수로 사용합니다.

세 번째 명령은 ShowWindowAsync를 호출합니다. 이 명령은 $pid 자동 변수와 함께 Get-Process cmdlet을 사용하여 현재 Windows PowerShell 세션을 호스팅하는 프로세스를 가져옵니다. 그런 다음 현재 프로세스의 MainWindowHandle 속성 및 SW_MINIMIZE 값을 나타내는 "2"를 사용합니다.

창을 복원하기 위해 네 번째 명령은 창 위치로 SW_RESTORE 값을 나타내는 "4"를 사용합니다. SW_MAXIMIZE는 3입니다.

C:\PS>Add-Type -MemberDefinition $jsMethod -Name "PrintInfo" -Language JScript

설명
-----------
이 명령은 Add-Type cmdlet을 사용하여 인라인 JScript 코드의 메서드를 Windows PowerShell 세션에 추가합니다. 이 명령은 MemberDefinition 매개 변수를 사용하여 $jsMethod 변수에 저장된 소스 코드를 전송하며, Name 변수를 사용하여 Add-Type이 메서드에 대해 만드는 클래스 이름을 지정하고 Language 매개 변수를 사용하여 JScript 언어를 지정합니다.

C:\PS>Add-Type -Path FSharp.Compiler.CodeDom.dll


C:\PS> Add-Type -Path FSharp.Compiler.CodeDom.dll
C:\PS> $provider = New-Object Microsoft.FSharp.Compiler.CodeDom.FSharpCodeProvider

C:\PS> $fSharpCode = @" 
let rec loop n = 
if n <= 0 then () else begin
print_endline (string_of_int n);
loop (n-1)
end
"@

C:\PS> $fsharpType = Add-Type -TypeDefinition $fSharpCode -CodeDomProvider $provider -PassThru | where { $_.IsPublic }
C:\PS> $fsharpType::loop(4)
4
3
2
1

설명
-----------
이 예에서는 Add-Type cmdlet을 사용하여 FSharp 코드 컴파일러를 Windows PowerShell 세션에 추가하는 방법을 보여 줍니다. Windows PowerShell에서 이 예를 실행하려면 FSharp 언어와 함께 설치되는 FSharp.Compiler.CodeDom.dll이 있어야 합니다.

예의 첫 번째 명령은 Add-Type cmdlet을 Path 매개 변수와 함께 사용하여 어셈블리를 지정합니다. Add-Type은 어셈블리의 유형을 가져옵니다.

두 번째 명령은 New-Object cmdlet을 사용하여 FSharp 코드 공급자의 인스턴스를 만든 다음 그 결과를 $provider 변수에 저장합니다.

세 번째 명령은 Loop 메서드를 정의하는 FSharp 코드를 $FSharpCode 변수에 저장합니다.

네 번째 명령은 Add-Type cmdlet을 사용하여 $fSharpCode에 정의된 public 유형을 $fSharpType 변수에 저장합니다. TypeDefinition 매개 변수는 해당 유형을 정의하는 소스 코드를 지정합니다. CodeDomProvider 매개 변수는 소스 코드 컴파일러를 지정합니다. 

PassThru 매개 변수는 해당 유형을 나타내는 Runtime 개체를 반환하도록 Add-Type에 지시하고 파이프라인 연산자(|)는 해당 Runtime 개체를 public 유형만 반환하는 Where-Object cmdlet으로 보냅니다. Where-Object 필터는 FSharp 공급자가 결과로 생성되는 public 유형을 지원하기 위해 public이 아닌 유형을 생성하기 때문에 사용됩니다.

다섯 번째 명령은 $fSharpType 변수에 저장된 유형의 정적 메서드로 Loop 메서드를 호출합니다.