Add-Type

Sözdizimi

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

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>]

Description

Cmdlet, Add-Type PowerShell oturumunuzda bir Microsoft .NET Core sınıfı tanımlamanızı sağlar. Ardından cmdlet'ini kullanarak nesnelerin örneğini New-Object oluşturabilir ve nesneleri herhangi bir .NET Core nesnesi gibi kullanabilirsiniz. PowerShell profilinize bir Add-Type komut eklerseniz, sınıfı tüm PowerShell oturumlarında kullanılabilir.

Var olan bir derleme veya kaynak kod dosyası belirterek türü belirtebilir veya kaynak kodu satır içinde veya bir değişkene kaydedilmiş olarak belirtebilirsiniz. Hatta yalnızca bir yöntem belirtebilir ve Add-Type sınıfını tanımlayıp oluşturabilirsiniz. Windows'da, PowerShell'de yönetilmeyen işlevlere Platform Çağırma (P/Invoke) çağrıları yapmak için bu özelliği kullanabilirsiniz. Kaynak kodu belirtirseniz, Add-Type belirtilen kaynak kodunu derler ve yeni .NET Core türlerini içeren bir bellek içi derleme oluşturur.

parametresini Add-Type kullanarak alternatif bir dil ve derleyici belirtebilirsiniz; C# varsayılandır, derleyici seçenekleri, derleme bağımlılıkları, sınıf ad alanı, türün adları ve sonuçta elde edilen derlemedir.

PowerShell 7'de başlayarak, Add-Type aynı ada sahip bir tür zaten varsa bir tür derlemez. Ayrıca, Add-Type içeren pwsh.dllklasörün altındaki bir ref klasörde derlemeleri arar.

Örnekler

Örnek 1: Oturuma .NET türü ekleme

Bu örnek, bir değişkende depolanan kaynak kodunu belirterek BasicTest sınıfını oturuma ekler. BasicTest sınıfı tamsayı eklemek, nesne oluşturmak ve tamsayıları çarpmak için kullanılır.

$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)

değişkeni, $Source sınıfı için kaynak kodunu depolar. türü adlı Add statik bir yönteme ve adlı Multiplystatik olmayan bir yönteme sahiptir.

cmdlet'i Add-Type sınıfını oturuma ekler. Satır içi kaynak kodu kullandığından komut, değişkendeki kodu belirtmek için TypeDefinition parametresini $Source kullanır.

Add BasicTest sınıfının statik yöntemi, sınıfın statik bir üyesini belirtmek için iki nokta üst üste karakterlerini (::) kullanır. Tamsayılar eklenir ve toplam görüntülenir.

cmdlet'i New-Object BasicTest sınıfının bir örneğini oluşturur. Yeni nesneyi değişkene $BasicTestObject kaydeder.

$BasicTestObjectMultiply yöntemini kullanır. Tamsayılar çarpılır ve ürün görüntülenir.

Örnek 2: Eklenen bir türü inceleme

Bu örnek, ve cmdlet'lerinin Örnek 1'de oluşturduğu nesneleri Add-Type incelemek için cmdlet'ini kullanırGet-Member.New-Object

[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()

cmdlet'iGet-Member, oturuma eklenen BasicTest sınıfının Add-Type türünü ve üyelerini alır. Get-Member komutu bunun System.Object sınıfından türetilen bir System.RuntimeType nesnesi olduğunu gösterir.

Static parametresi, Get-Member BasicTest sınıfının statik özelliklerini ve yöntemlerini alır. Çıkış, yöntemin Add dahil olduğunu gösterir.

cmdlet'i Get-Member değişkeninde depolanan nesnenin üyelerini $BasicTestObject alır. $BasicTestObject, BasicTest sınıfıyla cmdlet'i kullanılarak New-Object oluşturulmuştur. Çıkış, değişkeninin değerinin $BasicTestObject BasicTest sınıfının bir örneği olduğunu ve adlı Multiplybir üye içerdiğini gösterir.

Örnek 3: Derlemeden tür ekleme

Bu örnek, derlemedeki JsonSchema.NET.dll sınıfları geçerli oturuma ekler.

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

Set-Locationdeğişkeni belirtmek için Path parametresini $PSHOME kullanır. değişkeni, DLL dosyasının bulunduğu PowerShell yükleme dizinine başvurur.

$AccType değişkeni, cmdlet'iyle Add-Type oluşturulan bir nesneyi depolar. Add-Type derlemenin adını belirtmek için AssemblyName parametresini kullanır. Yıldız işareti (*) joker karakteri, adından veya yazım denetiminden emin olmamanız halinde bile doğru derlemeyi almanıza olanak tanır. PassThru parametresi, oturuma eklenen sınıfları temsil eden nesneler oluşturur.

Örnek 4: Yerel Windows API'lerini çağırma

Bu örnek, PowerShell'de yerel Windows API'lerinin nasıl çağrılduğunu gösterir. Add-Type , PowerShell'den bir işlevi User32.dll çağırmak için Platform Çağırma (P/Invoke) mekanizmasını kullanır. Bu örnek yalnızca Windows işletim sistemini çalıştıran bilgisayarlarda çalışır.

$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 değişkeni işlevin C# imzasını ShowWindowAsync depolar. Sonuçta elde edilen yöntemin bir PowerShell oturumunda görünür olduğundan emin olmak için anahtar public sözcüğü standart imzaya eklendi. Daha fazla bilgi için bkz . ShowWindowAsync işlevi.

değişkeni, $ShowWindowAsync PassThru parametresi tarafından Add-Type oluşturulan nesneyi depolar. cmdlet'i Add-Type işlevi PowerShell oturumuna statik bir yöntem olarak ekler ShowWindowAsync . komutu, değişkene kaydedilen yöntem tanımını belirtmek için MemberDefinition parametresini $Signature kullanır. komutu, sınıf için bir ad ve ad alanı belirtmek üzere Ad ve Ad Alanı parametrelerini kullanır. PassThru parametresi, türleri temsil eden bir nesne oluşturur.

PowerShell konsolunu simge durumuna küçültmek ve geri yüklemek için komutlarda yeni ShowWindowAsync statik yöntem kullanılır. yöntemi iki parametre alır: pencere tutamacı ve pencerenin nasıl görüntüleneceğini belirten bir tamsayı.

PowerShell konsolunu en aza indirmek için cmdlet'ini ShowWindowAsync $PID otomatik değişkenle birlikte kullanarak Get-Process geçerli PowerShell oturumunu barındıran işlemi alır. Ardından geçerli işlemin MainWindowHandle özelliğini ve değerini 2temsil SW_MINIMIZE eden değerini kullanır.

Pencereyi geri yüklemek için, ShowWindowAsync değeri temsil SW_RESTORE eden pencere konumu için değerini 4 kullanır.

Pencereyi en üst düzeye çıkarmak için öğesini temsil SW_MAXIMIZEeden değerini 3 kullanın.

Parametreler

-AssemblyName

-CompilerOptions

-IgnoreWarnings

-Language

-LiteralPath

-MemberDefinition

-Name

-Namespace

-OutputAssembly

-OutputType

-PassThru

-Path

-ReferencedAssemblies

-TypeDefinition

-UsingNamespace

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

Type

PassThru parametresini kullandığınızda, bu cmdlet yeni türü temsil eden bir System.Type nesnesi döndürür.

Notlar

Eklediğiniz türler yalnızca geçerli oturumda bulunur. Tüm oturumlarda türleri kullanmak için bunları PowerShell profilinize ekleyin. Profil hakkında daha fazla bilgi için bkz . about_Profiles.

Tür adları ve ad alanları bir oturum içinde benzersiz olmalıdır. Bir türü kaldıramaz veya değiştiremezsiniz. Bir türün kodunu değiştirmeniz gerekiyorsa, adı değiştirmeniz veya yeni bir PowerShell oturumu başlatmanız gerekir. Aksi takdirde, komut başarısız olur.

Windows PowerShell'de (sürüm 5.1 ve üstü), henüz yüklenmemiş her şey için kullanmanız Add-Type gerekir. En yaygın olarak bu, Genel Bütünleştirilmiş Kod Önbelleği'nde (GAC) bulunan derlemeler için geçerlidir. PowerShell 6 ve üzeri sürümlerde GAC yoktur, bu nedenle PowerShell kendi derlemelerini 'ye $PSHOMEyükler. Bu derlemeler istek üzerine otomatik olarak yüklenir, bu nedenle bunları yüklemek için kullanılması Add-Type gerekmez. Ancak, betiklerin PowerShell'in herhangi bir sürümüyle örtük olarak uyumlu olmasını sağlamak için kullanmaya Add-Type izin verilir.

GAC'deki derlemeler yol yerine tür adına göre yüklenebilir. Derlemelerin rastgele bir yoldan yüklenmesi gerekir Add-Typeçünkü bu derlemeler otomatik olarak yüklenemez.

İlişkili Bağlantılar

• about_Profiles
• about_Quoting_Rules
• Add-Member
• New-Object
• OutputAssemblyType
• Platform Çağırma (P/Invoke)
• Where-Object