Add-Type

Başvuru

Modül:: Microsoft.PowerShell.Utility

PowerShell oturumuna Bir Microsoft .NET sınıfı ekler.

Syntax

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 NJsonSchema.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-Typeoluş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

Türleri içeren bir derlemenin adını belirtir. Add-Type belirtilen derlemeden türleri alır. Derleme adını temel alan türler oluştururken bu parametre gereklidir.

Derlemenin kısmi adı olarak da bilinen tam veya basit adını girin. Derleme adında joker karakterlere izin verilir. Basit veya kısmi bir ad girerseniz, Add-Type bunu tam ada çözümler ve sonra derlemeyi yüklemek için tam adı kullanır.

Path veya LiteralPath parametrelerini kullanmak, yüklemeyi amaçladığınız derlemeyi yüklemenizi garanti eder. AssemblyName parametresini kullandığınızda PowerShell, .NET'den standart .NET derleme çözümleme işlemini kullanarak derleme adını çözümlemesini ister. .NET önce uygulama klasöründe arama olduğundan, Add-Type geçerli klasördeki sürüm yerine sürümünden $PSHOME bir derleme yükleyebilir. Daha fazla bilgi için bkz . Derleme konumu.

.NET adı çözemezse PowerShell, derlemeyi bulmak için geçerli konuma bakar. AssemblyName parametresinde joker karakterler kullandığınızda, .NET derleme çözümleme işlemi PowerShell'in geçerli konuma bakmasına neden olmaz.

Type:	String[]
Aliases:	AN
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	True

-CompilerOptions

Kaynak kod derleyicisi seçeneklerini belirtir. Bu seçenekler düzeltme yapılmadan derleyiciye gönderilir.

Bu parametre, derleyiciyi yürütülebilir dosya oluşturmaya, kaynakları eklemeye veya seçenek gibi komut satırı seçeneklerini ayarlamaya /unsafe yönlendirmenizi sağlar.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IgnoreWarnings

Derleyici uyarılarını yoksayar. Derleyici uyarılarını hata olarak işlemesini önlemek Add-Type için bu parametreyi kullanın.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Language

Kaynak kodda kullanılan dili belirtir. Bu parametre için kabul edilebilir değer: CSharp.

Type:	Language
Accepted values:	CSharp
Position:	Named
Default value:	CSharp
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LiteralPath

Kaynak kod dosyalarının veya türleri içeren derleme DLL dosyalarının yolunu belirtir. Path'in aksine, LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Path veya LiteralPath parametrelerini kullanmak, yüklemeyi amaçladığınız derlemeyi yüklemenizi garanti eder.

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MemberDefinition

Sınıfı için yeni özellikleri veya yöntemleri belirtir. Add-Type özellikleri veya yöntemleri desteklemek için gereken şablon kodunu oluşturur.

Windows'da, PowerShell'de yönetilmeyen işlevlere Platform Çağırma (P/Invoke) çağrıları yapmak için bu özelliği kullanabilirsiniz.

Type:	String[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Oluşturulacak sınıfın adını belirtir. Bir üye tanımından tür oluşturulurken bu parametre gereklidir.

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Namespace

Türü için bir ad alanı belirtir.

Bu parametre komuta dahil değilse, tür Microsoft.PowerShell.Commands.AddType.AutoGeneratedTypes ad alanında oluşturulur. parametresi komutuna boş bir dize değeriyle veya değeriyle $Nulldahil edilirse, tür genel ad alanında oluşturulur.

Type:	String
Aliases:	NS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OutputAssembly

Konumda belirtilen ada sahip derleme için bir DLL dosyası oluşturur. İsteğe bağlı bir yol ve dosya adı girin. Joker karakterlere izin verilir. Varsayılan olarak, Add-Type derlemeyi yalnızca bellekte oluşturur.

Type:	String
Aliases:	OA
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-OutputType

Çıkış derlemesinin çıkış türünü belirtir. Varsayılan olarak, hiçbir çıkış türü belirtilmez. Bu parametre yalnızca komutta bir çıkış derlemesi belirtildiğinde geçerlidir. Değerler hakkında daha fazla bilgi için bkz . OutputAssemblyType Numaralandırması.

Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:

ConsoleApplication
Library
WindowsApplication

Önemli

PowerShell 7.1 ConsoleApplication itibarıyla desteklenmez ve WindowsApplication OutputType parametresi için değer olarak belirtilirse PowerShell sonlandırıcı bir hata oluşturur.

Type:	OutputAssemblyType
Aliases:	OT
Accepted values:	ConsoleApplication, Library, WindowsApplication
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Eklenen türleri temsil eden bir System.Runtime nesnesi döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Kaynak kod dosyalarının veya türleri içeren derleme DLL dosyalarının yolunu belirtir.

Kaynak kod dosyalarını gönderirseniz, Add-Type dosyalarındaki kodu derler ve türlerin bellek içi derlemesini oluşturur. Path değerinde belirtilen dosya uzantısı, kullanan Add-Type derleyiciyi belirler.

Path veya LiteralPath parametrelerini kullanmak, yüklemeyi amaçladığınız derlemeyi yüklemenizi garanti eder.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ReferencedAssemblies

Türün bağlı olduğu derlemeleri belirtir. Varsayılan olarak, Add-Type ve başvurularını kullanır System.dllSystem.Management.Automation.dll. Bu parametreyi kullanarak belirttiğiniz derlemelere, varsayılan derlemelere ek olarak başvurulur.

PowerShell 6'da başlayan ReferencedAssemblies varsayılan .NET derlemelerini içermez. Bu parametreye geçirilen değere bunlara belirli bir başvuru eklemeniz gerekir.

Type:	String[]
Aliases:	RA
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TypeDefinition

Tür tanımlarını içeren kaynak kodunu belirtir. Kaynak kodu bir dizeye veya here-string'e girin ya da kaynak kodu içeren bir değişken girin. Here-strings hakkında daha fazla bilgi için bkz . about_Quoting_Rules.

Tür tanımınıza bir ad alanı bildirimi ekleyin. Ad alanı bildirimini atlarsanız, türünüz başka bir türle aynı ada veya başka bir tür için kısayola sahip olabilir ve yanlışlıkla üzerine yazılmasının nedeni olabilir. Örneğin, Özel Durum adlı bir tür tanımlarsanız, System.Exception kısayolu olarak Özel Durum kullanan betikler başarısız olur.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UsingNamespace

sınıfı için gereken diğer ad alanlarını belirtir. Bu, C# anahtar sözcüğüne Usingçok benzer.

Varsayılan olarak, Add-Type Sistem ad alanına başvurur. MemberDefinition parametresi kullanıldığında, Add-Type varsayılan olarak System.Runtime.InteropServices ad alanına da başvurur. UsingNamespace parametresini kullanarak eklediğiniz ad alanlarına, varsayılan ad alanlarına ek olarak başvurulur.

Type:	String[]
Aliases:	Using
Position:	Named
Default value:	System namespace
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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.

Add-Type

Syntax

Description

Örnekler

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

Örnek 2: Eklenen bir türü inceleme

Örnek 3: Derlemeden tür ekleme

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

Parametreler

-AssemblyName

-CompilerOptions

-IgnoreWarnings

-Language

-LiteralPath

-MemberDefinition

-Name

-Namespace

-OutputAssembly

-OutputType

-PassThru

-Path

-ReferencedAssemblies

-TypeDefinition

-UsingNamespace

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Add-Type

Syntax

Description

Örnekler

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

Örnek 2: Eklenen bir türü inceleme

Örnek 3: Derlemeden tür ekleme

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

Parametreler

-AssemblyName

-CompilerOptions

-IgnoreWarnings

-Language

-LiteralPath

-MemberDefinition

-Name

-Namespace

-OutputAssembly

-OutputType

-PassThru

-Path

-ReferencedAssemblies

-TypeDefinition

-UsingNamespace

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar