Add-Type

Add-Type
    [-TypeDefinition] <String>
    [-CodeDomProvider <CodeDomProvider>]
    [-CompilerParameters <CompilerParameters>]
    [-Language <Language>]
    [-ReferencedAssemblies <String[]>]
    [-OutputAssembly <String>]
    [-OutputType <OutputAssemblyType>]
    [-PassThru]
    [-IgnoreWarnings]
    [<CommonParameters>]

Add-Type
    [-Name] <String>
    [-MemberDefinition] <String[]>
    [-CodeDomProvider <CodeDomProvider>]
    [-CompilerParameters <CompilerParameters>]
    [-Namespace <String>]
    [-UsingNamespace <String[]>]
    [-Language <Language>]
    [-ReferencedAssemblies <String[]>]
    [-OutputAssembly <String>]
    [-OutputType <OutputAssemblyType>]
    [-PassThru]
    [-IgnoreWarnings]
    [<CommonParameters>]

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

Add-Type
    -LiteralPath <String[]>
    [-CompilerParameters <CompilerParameters>]
    [-ReferencedAssemblies <String[]>]
    [-OutputAssembly <String>]
    [-OutputType <OutputAssemblyType>]
    [-PassThru]
    [-IgnoreWarnings]
    [<CommonParameters>]

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

Add-Type cmdlet 允许在 PowerShell 会话中定义Microsoft .NET Framework 类。 然后，可以使用 New-Object cmdlet 实例化对象，并使用对象，就像使用任何 .NET Framework 对象一样。 如果将 Add-Type 命令添加到 PowerShell 配置文件，该类在所有 PowerShell 会话中均可用。

可以通过指定现有程序集或源代码文件来指定类型，也可以指定内联源代码或保存在变量中。 甚至可以仅指定一个方法和 Add-Type 定义和生成类。 在 Windows 上，可以使用此功能对 PowerShell 中的非托管函数进行平台调用（P/Invoke）。 如果指定源代码，Add-Type 编译指定的源代码并生成包含新 .NET Framework 类型的内存中程序集。

可以使用 Add-Type 的参数指定备用语言和编译器，C# 是默认的编译器选项、程序集依赖项、类命名空间、类型的名称和生成的程序集。

此示例通过指定存储在变量中的源代码，将 BasicTest 类添加到会话。 BasicTest 类用于添加整数、创建对象以及相乘整数。

$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);
    }
}
"@

Add-Type -TypeDefinition $Source
[BasicTest]::Add(4, 3)
$BasicTestObject = New-Object BasicTest
$BasicTestObject.Multiply(5, 2)

$Source 变量存储类的源代码。 该类型具有一个名为 Add 的静态方法，以及一个名为 Multiply的非静态方法。

Add-Type cmdlet 将类添加到会话中。 由于使用的是内联源代码，因此该命令使用 TypeDefinition 参数来指定 $Source 变量中的代码。

Add 类的 静态方法使用双冒号字符（::）来指定类的静态成员。 将添加整数并显示总和。

New-Object cmdlet 实例化 BasicTest 类的实例。 它将新对象保存在 $BasicTestObject 变量中。

$BasicTestObject 使用 Multiply 方法。 整数是相乘的，并显示产品。

此示例使用 Get-Member cmdlet 检查在 Add-Type中创建的 New-Object 和 cmdlet 的对象。

[BasicTest] | Get-Member

   TypeName: System.RuntimeType

Name                 MemberType Definition
----                 ---------- ----------
AsType               Method     type AsType()
Clone                Method     System.Object Clone(), System.Object ICloneable.Clone()
Equals               Method     bool Equals(System.Object obj), bool Equals(type o)
FindInterfaces       Method     type[] FindInterfaces(System.Reflection.TypeFilter filter...
...

[BasicTest] | Get-Member -Static

  TypeName: BasicTest

Name            MemberType Definition
----            ---------- ----------
Add             Method     static int Add(int a, int b)
Equals          Method     static bool Equals(System.Object objA, System.Object objB)
new             Method     BasicTest new()
ReferenceEquals Method     static bool ReferenceEquals(System.Object objA, System.Object objB)

$BasicTestObject | Get-Member

   TypeName: BasicTest

Name        MemberType Definition
----        ---------- ----------
Equals      Method     bool Equals(System.Object obj)
GetHashCode Method     int GetHashCode()
GetType     Method     type GetType()
Multiply    Method     int Multiply(int a, int b)
ToString    Method     string ToString()

Get-Member cmdlet 获取 添加到会话的 Add-Type 类的类型和成员。 命令显示它是一个 System.RuntimeType 对象，该对象派生自 system.Object 类 。

Get-Member Static 参数获取 BasicTest 类的静态属性和方法。 输出显示包含 Add 方法。

Get-Member cmdlet 获取存储在 $BasicTestObject 变量中的对象的成员。 $BasicTestObject 是通过将 New-Object cmdlet 与 BasicTest 类配合使用创建的。 输出显示 $BasicTestObject 变量的值是 BasicTest 类的实例，并且它包含名为 Multiply的成员。

此示例将 Accessibility.dll 程序集中的类添加到当前会话。

$AccType = Add-Type -AssemblyName "accessib*" -PassThru

$AccType 变量存储使用 Add-Type cmdlet 创建的对象。 Add-Type 使用 AssemblyName 参数指定程序集的名称。 星号（*）通配符允许你获取正确的程序集，即使你不确定名称或其拼写。 PassThru 参数生成表示添加到会话的类的对象。

此示例演示如何在 PowerShell 中调用本机 Windows API。 Add-Type 使用平台调用（P/Invoke）机制从 PowerShell 调用 User32.dll 中的函数。 此示例仅适用于运行 Windows 操作系统的计算机。

$Signature = @"
[DllImport("user32.dll")]public static extern bool ShowWindowAsync(IntPtr hWnd, int nCmdShow);
"@

$addTypeSplat = @{
    MemberDefinition = $Signature
    Name = "Win32ShowWindowAsync"
    Namespace = 'Win32Functions'
    PassThru = $true
}
$ShowWindowAsync = Add-Type @addTypeSplat

# Minimize the PowerShell console

$ShowWindowAsync::ShowWindowAsync((Get-Process -Id $PID).MainWindowHandle, 2)

# Restore the PowerShell console

$ShowWindowAsync::ShowWindowAsync((Get-Process -Id $PID).MainWindowHandle, 4)

$Signature 变量存储 ShowWindowAsync 函数的 C# 签名。 为了确保生成的方法在 PowerShell 会话中可见，public 关键字已添加到标准签名。 有关详细信息，请参阅 ShowWindowAsync 函数。

$ShowWindowAsync 变量存储由 Add-TypePassThru 参数创建的对象。 Add-Type cmdlet 将 ShowWindowAsync 函数作为静态方法添加到 PowerShell 会话。 该命令使用 MemberDefinition 参数指定保存在 $Signature 变量中的方法定义。 该命令使用 名称 和 命名空间 参数来指定类的名称和命名空间。 PassThru 参数生成表示类型的对象。

新的 ShowWindowAsync 静态方法用于命令中，以最小化和还原 PowerShell 控制台。 该方法采用两个参数：窗口句柄和一个指定窗口显示方式的整数。

为了最大程度地减少 PowerShell 控制台，ShowWindowAsync 使用具有 Get-Process 自动变量的 $PID cmdlet 来获取托管当前 PowerShell 会话的进程。 然后，它使用当前进程的 MainWindowHandle 属性和表示 2 值的 SW_MINIMIZE值。

若要还原窗口，ShowWindowAsync 对表示 4 值的窗口位置使用 SW_RESTORE 值。

若要最大化窗口，请使用表示 3SW_MAXIMIZE 的值。

此示例使用 Add-Type cmdlet 将 VBFromFile 类添加到当前会话 Hello.vb 文件中定义的类。 命令输出中显示了 Hello.vb 文件的文本。

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

Hello, World

Add-Type 使用 Path 参数来指定源文件，Hello.vb并添加文件中定义的类型。 SayHello 函数作为 VBFromFile 类的静态方法调用。

此示例使用 JScript.NET 在 PowerShell 会话中创建一个新类，FRectangle。

Add-Type @'
 class FRectangle {
   var Length : double;
   var Height : double;
   function Perimeter() : double {
       return (Length + Height) * 2; }
   function Area() : double {
       return Length * Height;  } }
'@ -Language JScript

$rect = [FRectangle]::new()
$rect

Length Height
------ ------
     0      0

此示例演示如何使用 Add-Type cmdlet 将 F# 代码编译器添加到 PowerShell 会话。 若要在 PowerShell 中运行此示例，必须使用 F# 语言安装 FSharp.Compiler.CodeDom.dll。

Add-Type -Path "FSharp.Compiler.CodeDom.dll"
$Provider = New-Object Microsoft.FSharp.Compiler.CodeDom.FSharpCodeProvider
$FSharpCode = @"
let rec loop n =if n <= 0 then () else beginprint_endline (string_of_int n);loop (n-1)end
"@
$FSharpType = Add-Type -TypeDefinition $FSharpCode -CodeDomProvider $Provider -PassThru |
   Where-Object { $_.IsPublic }
$FSharpType::loop(4)

4
3
2
1

Add-Type 使用 Path 参数指定程序集并获取程序集中的类型。 New-Object 创建 F# 代码提供程序的实例，并将结果保存在 $Provider 变量中。 $FSharpCode 变量保存用于定义 循环 方法的 F# 代码。

$FSharpType 变量存储保存 Add-Type中定义的公共类型的 $FSharpCode cmdlet 的结果。 TypeDefinition 参数指定定义类型的源代码。 CodeDomProvider 参数指定源代码编译器。 PassThru 参数指示 Add-Type 返回表示类型的 Runtime 对象。 对象将管道向下发送到 Where-Object cmdlet，该 cmdlet 仅返回公共类型。 使用 Where-Object cmdlet 是因为 F# 提供程序生成非公共类型以支持生成的公共类型。

循环方法作为存储在 $FSharpType 变量中的类型的静态方法调用。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能用管道将对象传送到此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 返回表示新类型的 System.Type 对象。

添加的类型仅存在于当前会话中。 若要在所有会话中使用类型，请将它们添加到 PowerShell 配置文件。 有关配置文件的详细信息，请参阅 about_Profiles。

类型名称和命名空间在会话中必须是唯一的。 无法卸载类型或更改它。 如果需要更改类型的代码，则必须更改名称或启动新的 PowerShell 会话。 否则，命令将失败。

某些语言（如 IronPython 和 J#）的 CodeDomProvider 类不会生成输出。 因此，用这些语言编写的类型不能与 Add-Type一起使用。

此 cmdlet 基于 Microsoft .NET Framework CodeDomProvider 类。