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.

Вторая команда использует командлет Add-Type для добавления класса в сеанс. Поскольку используется встроенный исходный код, для указания кода в переменной $source команда использует параметр TypeDefinition.

Оставшиеся команды используют новый класс.

Третья команда вызывает статический метод Add класса BasicTest. Для указания статических элементов класса используются двойные двоеточия (::).

Четвертая команда использует командлет New-Object для создания экземпляра класса BasicTest. Она сохраняет новый объект в переменной $basicTestObject. 

Пятая команда использует метод Multiply объекта $basicTestObject.

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, чтобы получить тип и элементы класса BasicTest, добавленного в сеанс с помощью командлета Add-Type. Командлет Get-Member позволяет узнать, чтоб объект имеет тип System.RuntimeType, являющийся производным для класса System.Object.

Вторая команда использует параметр Static командлета Get-Member, чтобы получить статические свойства и статические методы класса BasicTest. Результат содержит метод Add.

Третья команда использует командлет Get-Member, чтобы получить элементы объекта, хранящегося в переменной $BasicTestObject. Это экземпляр объекта класса $BasicType, созданного с помощью командлета New-Object. 

Результат выполнения команды показывает, что значение переменной $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 используется для добавления в текущий сеанс класса VBFromFile, определенного в файле Hello.vb. Текст файла Hello.vb показан в результатах выполнения команды.

Первая команда использует командлет Add-Type для добавления в текущий сеанс типа, определенного в файле Hello.vb. Для указания исходного файла в этой команде используется параметр path. 

Вторая команда вызывает функцию 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 собственные API Windows. Командлет Add-Type использует механизм вызова неуправляемого кода, чтобы вызвать в Windows PowerShell функцию из файла User32.dll.

Первая команда сохраняет в переменной $signature сигнатуру C# функции ShowWindowAsync. (Дополнительные сведения см. в разделе "Функция ShowWindowAsync" библиотеки MSDN по адресу  (на английском языке).) Чтобы получаемый в результате метод был доступен в сеансе Windows PowerShell, к стандартной сигнатуре было добавлено ключевое слово "public".

Вторая команда использует командлет Add-Type для добавления функции ShowWindowAsync в сеанс Windows PowerShell в качестве статического метода класса, создаваемого командлетом Add-Type. Команда использует параметр MemberDefinition для задания определения метода, сохраняемого в переменной $signature.
 
Команда использует параметры Name и Namespace для задания имени и пространства имен класса. Она использует параметр PassThru, чтобы создать объект, представляющий типы, и сохраняет этот объект в переменной $showWindowAsync.

В третьей и четвертой командах используется новый статический метод ShowWindowAsync. Этот метод принимает два параметра — дескриптор окна и целое значение, определяющее отображение окна.

Третья команда вызывает метод ShowWindowAsync. Она использует командлет Get-Process с автоматической переменной $pid, чтобы получить процесс, в котором работает текущий сеанс Windows PowerShell. После этого она использует свойство MainWindowHandle текущего процесса и значение 2, соответствующее значению SW_MINIMIZE.

Чтобы восстановить окно, четвертая команда использует для определения положения окна значение 4, что соответствует значению SW_RESTORE. (Положению SW_MAXIMIZE соответствует значение 3.)

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

Описание
-----------
Эта команда использует командлет Add-Type, чтобы добавить в сеанс Windows PowerShell метод из встроенного кода JScript. Для отправки исходного кода, хранящегося в переменной $jsMethod, используется параметр MemberDefinition. Команда использует переменную 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 добавить в сеанс Windows PowerShell компилятор кода FSharp. Чтобы запустить этот пример в Windows PowerShell, требуется сборка FSharp.Compiler.CodeDom.dll, устанавливаемая вместе с языком FSharp.

Первая команда в этом примере использует командлет Add-Type с параметром Path, чтобы задать сборку. Командлет Add-Type получает типы из сборки.

Вторая команда использует командлет New-Object, чтобы создать экземпляр поставщика кода FSharp, и сохраняет результат в переменной $provider.

Третья команда сохраняет код FSharp, который определяет метод Loop в переменной $FSharpCode.

Четвертая команда использует командлет Add-Type, чтобы сохранить в переменной $fSharpType общие типы, определенные в переменной $fSharpCode. Параметр TypeDefinition задает исходный код, в котором определены типы. Параметр CodeDomProvider задает компилятор исходного кода. 

Параметр PassThru означает, что командлет Add-Type должен вернуть объект Runtime, представляющий типы, а оператор конвейера (|) передает объект Runtime командлету Where-Object, который возвращает только общие типы. Фильтр Where-Object используется потому, что поставщик FSharp создает для поддержки конечного общего типа типы, не являющиеся общими.

Пятая команда вызывает метод Loop в качестве статического метода типа, хранящегося в переменной $fSharpType.