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

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

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

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

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

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

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

从 PowerShell 7 开始，如果已存在同名的类型，则 Add-Type 不会编译类型。 此外， Add-Type 查找包含 pwsh.dll 的文件夹下的 ref 文件夹中的程序集。

示例 1：向会话添加 .NET 类型

此示例通过指定存储在变量中的源代码，将 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 变量中的代码。

BasicTest 类的 Add 静态方法使用双冒号字符 ( :: ) 来指定该类的静态成员。 将整数相加并显示总和。

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

$BasicTestObject 使用 Multiply 方法。 将整数相乘并显示乘积。

示例 2：检查添加的类型

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

[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 添加到会话的 BasicTest 类的类型和成员。 Get-Member 命令表明它是一个派生自 System.Object 类的 System.RuntimeType 对象。

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

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

示例 3：从程序集中添加类型

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

Set-Location -Path $PSHOME
$AccType = Add-Type -AssemblyName *jsonschema* -PassThru

Set-Location 使用 Path 参数来指定 $PSHOME 变量。 该变量引用 DLL 文件所在的 PowerShell 安装目录。

$AccType 变量存储使用 Add-Type cmdlet 创建的对象。 Add-Type 使用 AssemblyName 参数来指定程序集的名称。 使用星号 ( * ) 通配符，甚至可在不确定程序集名称或其拼写时获取正确的程序集。 PassThru 参数生成表示添加到会话中的类的对象。

示例 4：调用本机 Windows API

此示例演示如何在 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 变量存储 PassThru Add-Type 参数创建的对象。 Add-Type cmdlet 将 ShowWindowAsync 函数作为静态方法添加到 PowerShell 会话。 该命令使用 MemberDefinition 参数来指定保存在 $Signature 变量中的方法定义。 该命令使用 Name 和 Namespace 参数来指定类的名称和命名空间。 PassThru 参数生成一个表示类型的对象。