Add-Type

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

Add-Type [-Name] <string> [-MemberDefinition] <string[]> [-CodeDomProvider <CodeDomProvider>] [-CompilerParameters <CompilerParameters>] [-Language {<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>] [-Language {<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 変数にクラスのソース コードを保存します。

2 番目のコマンドは、Add-Type コマンドレットを使用してセッションにクラスを追加します。インライン ソース コードを使用しているため、このコマンドは TypeDefinition パラメーターを使用して $source 変数にコードを指定します。

残りのコマンドは新しいクラスを使用します。

3 番目のコマンドは、BasicTest クラスの Add 静的メソッドを呼び出します。これはダブルコロン文字 (::) を使用して、クラスの静的メンバーを指定します。

4 番目のコマンドは、New-Object コマンドレットを使用して BasicTest クラスのインスタンスをインスタンス化します。新しいオブジェクトは $basicTestObject 変数に保存されます。

5 番目のコマンドは、$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 コマンドレットを使用して、Add-Type コマンドレットおよび New-Object コマンドレットにより前の例で作成されたオブジェクトを確認します。

最初のコマンドは、Get-Member コマンドレットを使用して、Add-Type によりセッションに追加された BasicTest クラスの型とメンバーを取得します。Get-Member コマンドによって、System.Object クラスから派生しているのが System.RuntimeType オブジェクトであることがわかります。

2 番目のコマンドは、Get-Member の Static パラメーターを使用して、BasicTest クラスの静的プロパティとメソッドを取得します。出力には、Add メソッドが含まれていることが示されています。

3 番目のコマンドは、Get-Member を使用して、$BasicTestObject 変数に保存されているオブジェクトのメンバーを取得します。これは、New-Object コマンドレットを使用して $BasicType クラスで作成されたオブジェクト インスタンスです。

出力では、$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 コマンドレットを使用して、Hello.vb ファイルに定義されている VBFromFile クラスを現在のセッションに追加します。Hello.vb ファイルのテキストは、コマンドの出力に表示されます。

最初のコマンドは、Add-Type コマンドレットを使用して、Hello.vb ファイルに定義されている型を現在のセッションに追加します。このコマンドは、Path パラメーターを使用してソース ファイルを指定します。

2 番目のコマンドは、SayHello 関数を VBFromFile クラスの静的メソッドとして呼び出します。

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 は、プラットフォーム Invoke (P/Invoke) メカニズムを使用して、Windows PowerShell から User32.dll の関数を呼び出します。

最初のコマンドは、ShowWindowAsyn 関数の C# 署名を $signature 変数に保存します (詳細については、MSDN ライブラリの「ShowWindowAsync Function (ShowWindowAsync 関数)」(https://go.microsoft.com/fwlink/?LinkId=143643) を参照してください)。結果のメソッドが Windows PowerShell セッションに表示されることを確認するために、"public" キーワードが標準署名に追加されています。

2 番目のコマンドは、Add-Type コマンドレットを使用して Add-Type により作成されるクラスの静的メソッドとして ShowWindowAsync 関数を Windows PowerShell セッションに追加します。このコマンドは、MemberDefinition パラメーターを使用して $signature 変数に保存されたメソッド定義を指定します。
 
このコマンドは、Name パラメーターおよび Namespace パラメーターを使用して、クラスの名前と名前空間を指定します。これは、PassThru パラメーターを使用して型を表すオブジェクトを生成し、そのオブジェクトを $showWindowAsync 変数に保存します。

3 番目と 4 番目のコマンドは新しい ShowWindowAsync 静的メソッドを使用します。このメソッドには、ウィンドウ ハンドル、およびウィンドウの表示方法を指定する整数という 2 つのパラメーターがあります。

3 番目のコマンドは ShowWindowAsync を呼び出します。これは Get-Process コマンドレットを $pid 自動変数と共に使用して、現在の Windows PowerShell セッションをホストしているプロセスを取得します。その後、現在のプロセスの MainWindowHandle プロパティと、SW_MINIMIZE 値を表す値 "2" を使用します。

4 番目のコマンドは、ウィンドウを復元するために、ウィンドウの位置に対して値 "4" (SW_RESTORE 値を表す) を使用します (SW_MAXIMIZE は 3 です)。

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

説明
-----------
このコマンドは、Add-Type コマンドレットを使用して、インライン 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 コマンドレットを使用して FSharp コード コンパイラを Windows PowerShell セッションに追加する方法を示しています。Windows PowerShell でこの例を実行するには、FSharp 言語でインストールされた FSharp.Compiler.CodeDom.dll が存在する必要があります。

例の最初のコマンドは、Add-Type コマンドレットを Path パラメーターと共に使用してアセンブリを指定します。Add-Type は、アセンブリの型を取得します。

2 番目のコマンドは、New-Object コマンドレットを使用して FSharp コード プロバイダーのインスタンスを作成し、結果を $provider 変数に保存します。

3 番目のコマンドは、$FSharpCode 変数に Loop メソッドを定義する FSharp コードを保存します。

4 番目のコマンドは、Add-Type コマンドレットを使用して、$fSharpCode に定義されたパブリック型を $fSharpType 変数に保存します。TypeDefinition パラメーターは、型を定義するソース コードを指定します。CodeDomProvider パラメーターはソース コード コンパイラを指定します。

PassThru パラメーターは、型を表す Runtime オブジェクトを返すことを Add-Type に指示し、Runtime オブジェクトがパイプライン演算子 (|) によりパブリック型のみを返す Where-Object コマンドレットに送られます。FSharp プロバイダーは非パブリック型を作成して結果のパブリック型をサポートするため、Where-Object フィルターが使用されます。

5 番目のコマンドは、Loop メソッドを、$fSharpType 変数に保存された型の静的メソッドとして呼び出します。