Aracılığıyla paylaş


4. Türler

Editörün notu

Önemli

Windows PowerShell Dil Belirtimi 3.0 Aralık 2012'de yayımlanmıştır ve Windows PowerShell 3.0'ı temel alır. Bu belirtim PowerShell'in geçerli durumunu yansıtmaz. Bu belgeleri geçerli durumu yansıtacak şekilde güncelleştirme planı yoktur. Bu belgeler, geçmişe yönelik başvuru için burada sunulmuştur.

Belirtim belgesi, Şu konumdaki Microsoft İndirme Merkezi'nden bir Microsoft Word belgesi olarak kullanılabilir: https://www.microsoft.com/download/details.aspx?id=36389 Bu Word belgesi burada Microsoft Learn'de sunu için dönüştürülmüştür. Dönüştürme sırasında, Docs platformu için biçimlendirmeye uyum sağlamak için bazı editoryal değişiklikler yapılmıştır. Bazı yazım hataları ve küçük hatalar düzeltildi.

PowerShell'de her değerin bir türü vardır ve türler iki ana kategoriden birine ayrılır: değer türleri ve başvuru türleri. değer türlerinin tipik türü olan inttürünü göz önünde bulundurun. int türündeki bir değer tamamen bağımsızdır; bu değeri temsil etmek için gereken tüm bitler bu değerde depolanır ve bu değerdeki her bit deseni türü için geçerli bir değeri temsil eder. Şimdi, başvuru türlerinde tipik olan int[]dizi türünü göz önünde bulundurun. Dizi türü değerinin sözde hali, ya dizi öğelerini gerçek anlamda içeren bir nesneye referans veya değeri olan $null null referans tutabilir. İki tür kategorisi arasındaki önemli ayrım, atama sırasında semantiğindeki farklarla en iyi şekilde gösterilmiştir. Örneğin

$i = 100 # $i designates an int value 100
$j = $i # $j designates an int value 100, which is a copy

$a = 10,20,30 # $a designates an object[], Length 3, value 10,20,30
$b = $a # $b designates exactly the same array as does $a, not a copy
$a[1] = 50 # element 1 (which has a value type) is changed from 20 to 50
$b[1] # $b refers to the same array as $a, so $b[1] is 50

Gördüğümüz gibi, referans türü değerinin ataması yüzeysel bir kopyayıiçerir; yani, nesneye olan referansın kopyası yapılır, nesnenin gerçek değeri değil. Buna karşılık, derin kopya de nesnenin bir kopyasının yapılmasını gerektirir.

sayısal türü, tamsayı veya kesirli değerlerin temsilini sağlayan ve bu değerler üzerinde aritmetik işlemleri destekleyen türdür. Sayısal türler kümesi tamsayı (§4.2.3) ve gerçek sayı (§4.2.4) türlerini içerir, ancak bool (§4.2.1) veya char (§4.2.2) içermez. Bir uygulama başka sayısal türler (imzalı bayt, işaretsiz tamsayı ve diğer boyutlardaki tamsayılar gibi) sağlayabilir.

koleksiyonu, aynı türde olması gerekmeyen bir veya daha fazla ilgili öğeden oluşan bir gruptur. Koleksiyon türlerine örnek olarak diziler, yığınlar, kuyruklar, listeler ve karma tablolar verilebilir. Bir program bir koleksiyondaki öğeler üzerinde numaralandırabilir (veya yineleyebilir) ve her öğeye birer birer erişebilir. Bunu yapmanın yaygın yöntemleri, foreach deyimi (§8.4.4) ve ForEach-Object cmdlet'idir. Bir numaralandırıcıyı temsil eden nesnenin türü §4.5.16içinde açıklanmıştır.

Bu bölümde, belirli bir tür için erişilebilir üyeleri listeleyen tablolar vardır. Yöntemler için Type şu formla yazılır: returnType/argumentTypeList. Bağımsız değişken türü listesi bu sütuna sığmayacak kadar uzunsa, bunun yerine Amaç sütununda gösterilir.

Diğer tamsayı türleri, hepsi SBytead alanında olan Int16, UInt16, UInt32, UInt64ve 'tür.

Birçok koleksiyon sınıfı, System.Collections veya System.Collections.Generic ad alanlarının bir parçası olarak tanımlanır. Çoğu koleksiyon sınıfı, ICollection, IComparer, IEnumerable, IList, IDictionaryve IDictionaryEnumerator arabirimlerini ve bunların genel eşdeğerlerini uygular.

Bazı türler için kısaltma adları da kullanabilirsiniz. Daha fazla bilgi için bkz. about_Type_Accelerators.

4.1 Özel türler

4.1.1 Boşluk türü

Bu tür örneği oluşturulamaz. Dönüştürme işlecini (§7.2.9) kullanarak bir değeri açıkça atmanın bir yolunu sağlar.

4.1.2 Null tür

null türünün, null değer olarak da bilinen bir örneği olan otomatik değişken $null (§2.3.2.2) vardır. Bu değer, başvuru bağlamlarında "hiçliği" ifade etmek için bir araç sağlar. Bu türün özellikleri belirtilmemiştir.

4.1.3 Nesne türü

PowerShell'de null tür dışındaki her tür (§4.1.2) tür nesnesinden doğrudan veya dolaylı olarak türetilir, bu nedenle nesne tüm null olmayan türlerin nihai temel türüdür. Nesne yazmak için kısıtlanmış bir değişken (§5,3) herhangi bir türde değer içerebildiğinden gerçekten hiç kısıtlanmaz.

4.2 Değer türleri

4.2.1 Boole dili

Boole türü bool. Bu tür yalnızca iki değer vardır: False ve True, sırasıyla $false ve $trueotomatik değişkenleriyle gösterilir (§2.3.2.2).

PowerShell'de bool, System.Booleanile eşleşir.

4.2.2 Karakter

Bir karakter değeri, herhangi bir UTF-16 ile kodlanmış 16 bit Unicode kod noktasını depolayabilen char türüne sahiptir.

Char türü aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
MaksimumDeğer Statik özellik (salt okunur) karakter "char" türünün mümkün olan en büyük değeri
Minimum Değer Statik özellik (salt okunur) karakter Char türünün mümkün olan en küçük değeri
IsControl Statik yöntem bool/char Karakterin bir denetim karakteri olup olmadığını sınar
IsDigit Statik yöntem bool/char Karakterin ondalık rakam olup olmadığını sınar
IsLetter Statik yöntem bool/char Karakterin alfabetik harf olup olmadığını sınar
IsLetterOrDigit Statik yöntem bool/char Karakterin ondalık basamak mı yoksa alfabetik harf mi olduğunu sınar
IsLower Statik yöntem bool/char Karakterin küçük harf alfabetik harf olup olmadığını sınar
Noktalama İmiMi Statik yöntem bool/char Karakterin noktalama işareti olup olmadığını sınar
IsUpper Statik yöntem bool/char Karakterin büyük harfli alfabe harfi olup olmadığını test eder
IsWhiteSpace Statik yöntem bool/char Karakterin bir boşluk karakteri olup olmadığını sınar.
ToLower Statik yöntem karakter/dizi Karakteri küçük harfe dönüştürür
ToUpper Statik yöntem karakter/dizi Karakteri büyük harfe dönüştürür

Windows PowerShell: char, System.Char ile karşılık gelir.

4.2.3 Tamsayı

İki imzalı tamsayı türü vardır ve her ikisi de negatif değerler için ikinin tamamlayıcı gösterimini kullanır:

  • -2147483648 ile +2147483647 (dahil) arasında bir aralık sağlayan 32 bit kullanan inttürünü yazın.
  • 64 bit kullanan ve -9223372036854775808 ile +9223372036854775807 arasını kapsayan longtipi.

Int türü aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
MaksimumDeğer Statik özellik (salt okunur) Int Int türünün mümkün olan en büyük değeri
Minimum Değer Statik özellik (salt okunur) Int Int türünün mümkün olan en küçük değeri

Long türünde aşağıdaki erişilebilir üyeler vardır:

Üye Üye Türü Tür Amaç
MaksimumDeğer Statik özellik (salt okunur) uzun Long türünün mümkün olan en büyük değeri
Minimum Değer Statik özellik (salt okunur) uzun Long türünde mümkün olan en küçük değer

İmzasız bir tamsayı türü vardır:

  • 8 bit kullanarak 0 ile 255 (dahil) arasında bir aralık sağlayan byte'ı yazın.

Tür byte aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
MaksimumDeğer Statik özellik (salt okunur) byte (bayt) Bayt türündeki mümkün olan en büyük değer
Minimum Değer Statik özellik (salt okunur) byte (bayt) byte türünün alabileceği en küçük değer

PowerShell'de byte, intve long sırasıyla System.Byte, System.Int32ve System.Int64ile eşleşir.

4.2.4 Gerçek sayı

4.2.4.1 float ve double

İki gerçek (veya kayan nokta) türü vardır:

  • Tür float, 32-bit IEEE tek duyarlık gösterimini kullanır.
  • Tür double, 64-bit IEEE çift hassasiyetli gösterimi kullanır.

Üçüncü tür adı olan single, floattürü için bir eş anlamlıdır; float bu belirtim boyunca kullanılmaktadır.

float ve double türlerinin boyutu ve gösterimi bu belirtim tarafından tanımlansa da, bir uygulama ara sonuçlar için genişletilmiş duyarlık kullanabilir.

Float türünde aşağıdaki erişilebilir üyeler vardır:

Üye Üye Türü Tür Amaç
MaksimumDeğer Statik özellik (salt okunur) yüzmek Float veri tipi için mümkün olan en büyük değer
Minimum Değer Statik özellik (salt okunur) yüzmek Float türünün mümkün olan en küçük değeri
NaN Statik özellik (salt okunur) yüzmek Sayı Olmayan sabit değeri
Negatif Sonsuzluk Statik özellik (salt okunur) yüzmek Sabit değer negatif sonsuzluk
PositiveInfinity Statik özellik (salt okunur) yüzmek Sabit değer pozitif sonsuzluk

Double türü aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
MaksimumDeğer Statik özellik (salt okunur) çift double türünde mümkün olan en büyük değer
Minimum Değer Statik özellik (salt okunur) çift double türünde mümkün olan en küçük değer
NaN Statik özellik (salt okunur) çift Sayı Olmayan sabit değeri
Negatif Sonsuzluk Statik özellik (salt okunur) çift Sabit değer negatif sonsuzluk
PositiveInfinity Statik özellik (salt okunur) çift Sabit değer pozitif sonsuzluk

PowerShell'de float ve double, sırasıyla System.Single ve System.Double'e eşlenir.

4.2.4.2 ondalık

Ondalık türü, 128 bitlik bir gösterim kullanır. Ölçek s, 0 <= s<= en az 28 olacak şekilde desteklenmeli ve ayrıca değer aralığı -79228162514264337593543950335 ile 79228162514264337593543950335 arasında olmalıdır. Ondalık değerin gerçek gösterimi, uygulama tarafından belirlenir.

Tür ondalık aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
MaksimumDeğer Statik özellik (salt okunur) On -da -lık Decimal türündeki olası en büyük değer
Minimum Değer Statik özellik (salt okunur) On -da -lık Ondalık veri türünün mümkün olan en küçük değeri

Not

Ondalık gerçek sayılar, ondalık virgülünün sağındaki basamak sayısını temsil eden ölçekadlı bir özelliğe sahiptir. Örneğin, 2,340 değerinin ölçeği 3'tür ve sonunda sıfırlar önemlidir. İki ondalık gerçek sayı eklendiğinde veya çıkarıldığında, sonucun ölçeği iki ölçeğin daha büyüktür. Örneğin, 1.0 + 2.000 3.000 iken 5.0 - 2.00 3.00 olur. İki ondalık gerçek sayı çarpıldığında, sonucun ölçeği iki ölçeğin toplamıdır. Örneğin, 1.0 * 2.000 2.0000'dir. İki ondalık gerçek sayı bölündüğünde, sonucun ölçeği ilk sayının ölçeğinden ikinci sayının ölçeğinin çıkarılmasıyla elde edilir. Örneğin, 4.00000/2.000 2.00'dır. Ancak, bir ölçek doğru sonucu korumak için gerekenden küçük olamaz. Örneğin, 3.000/2.000, 3.00/2.000, 3.0/2.000 ve 3/2 1,5'tır.

PowerShell'de decimal, System.Decimalile eşleşir. Ondalık gösterimi aşağıdaki gibidir:

  • Dört int değeri içeren bir dizi olarak kabul edildiğinde aşağıdaki öğeleri içerir:
    • Dizin 0 (bit 0-31), ondalık katsayısının düşük sıralı 32 bitini içerir.
    • Dizin 1 (bit 32-63), ondalık katsayısının orta 32 bitini içerir.
    • Dizin 2 (bit 64-95), ondalık katsayısının yüksek sıralı 32 bitini içerir.
    • Dizin 3 (bit 96-127) aşağıdaki gibi işaret bitini ve ölçeğini içerir:
      • bit 0--15 sıfırdır
      • bit 16-23 ölçek değerini 0--28 olarak içerir
      • bit 24-30 sıfırdır
      • bit 31 işaretidir (pozitif için 0, negatif için 1)

4.2.5 Anahtar türü

Bu tür, bir komuttaki parametrenin türünü kısıtlamak için kullanılır (§8.10.5). Karşılık gelen parametre adına sahip bir bağımsız değişken varsa, parametre $true olarak test edilir; aksi takdirde $falseolarak test edilir.

PowerShell'de switch, System.Management.Automation.SwitchParameterile eşleşir.

4.2.6 Numaralandırma türleri

Numaralandırma türü, bu numaralandırma türündeki bir nesneye atanabilecek tüm olası değerleri temsil eden adlandırılmış sabit kümesini tanımlayan türdür. Bazı durumlarda, değer kümesi aynı anda yalnızca bir değer temsil edilebilecek şekildedir. Diğer durumlarda, değer kümesi iki farklı güçtedir ve -bor işleci (§7.8.5) kullanılarak aynı nesnede birden çok değer kodlanabilir.

PowerShell ortamı, aşağıdaki bölümlerde açıklandığı gibi bir dizi numaralandırma türü sağlar.

4.2.6.1 Action-Preference türü

Bu uygulama tanımlı tür, aşağıdaki birbirini dışlayan değerli erişilebilir üyelere sahiptir:

Üye Üye Türü Amaç
Devam etmek Sıralı sabit PowerShell çalışma zamanı işlemeye devam eder ve kullanıcıya bir eylemin gerçekleştiğini bildirir.
Sorgulamak Sıralı sabit PowerShell çalışma zamanı işlemeyi durdurur ve kullanıcıya nasıl devam etmesi gerektiğini sorar.
SessizceDevamEt Sıralı sabit PowerShell çalışma zamanı, kullanıcıya bir eylemin gerçekleştiğini bildirmeden işlemeye devam eder.
Durmak Sıralı sabit Bir eylem gerçekleştiğinde PowerShell çalışma zamanı işlemeyi durdurur.

PowerShell'de bu tip System.Management.Automation.ActionPreference.

4.2.6.2 Confirm-Impact türü

Bu uygulama tanımlı tür, aşağıdaki birbirini dışlayan değerli erişilebilir üyelere sahiptir:

Üye Üye Türü Amaç
Yüksek Sıralı sabit Gerçekleştirilen eylemin, sabit diski yeniden biçimlendirme gibi verileri kaybetme riski yüksektir.
Düşük Sıralı sabit Gerçekleştirilen eylemin veri kaybı riski düşüktür.
Orta Sıralı sabit Gerçekleştirilen eylemin veri kaybı riski orta düzeydedir.
Hiç kimse Sıralı sabit Hiçbir eylemi onaylamayın (onay için tüm istekleri gizleyin).

PowerShell'de bu tip System.Management.Automation.ConfirmImpact.

4.2.6.3 File-Attributes türü

Bu uygulama tanımlı tür, birleştirilebilen aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Amaç
Arşiv Sıralı sabit Dosyanın arşiv durumu. Uygulamalar, dosyaları yedekleme veya kaldırma amacıyla işaretlemek için bu özniteliği kullanır.
Sıkıştırılmış Sıralı sabit Dosya sıkıştırılır.
Aygıt Gelecekte kullanmak üzere ayrılmıştır.
Dizin Sıralı sabit Dosya bir dizindir.
Şifrelenmiş Sıralı sabit Dosya veya dizin şifrelenir. Bir dosya için bu, dosyadaki tüm verilerin şifrelendiğini gösterir. Bir dizin için bu, şifrelemenin yeni oluşturulan dosyalar ve dizinler için varsayılan olduğu anlamına gelir.
Gizli Sıralı sabit Dosya gizlidir ve bu nedenle sıradan bir dizin listesine eklenmez.
Normal Sıralı sabit Dosya normaldir ve başka öznitelik ayarlanmadı. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir.
İçerik Dizini Oluşturulmamış Sıralı sabit Dosya, işletim sisteminin içerik dizin oluşturma hizmeti tarafından dizine alınmaz.
Çevrimdışı Sıralı sabit Dosya çevrimdışı. Dosyanın verileri hemen erişilebilir değil.
Salt Okunabilir Sıralı sabit Dosya salt okunur.
Reparse Point (Yeniden Ayrıştırma Noktası) Sıralı sabit Dosya, bir dosya veya dizinle ilişkilendirilmiş kullanıcı tanımlı veri bloğu olan bir yeniden ayrıştırma noktası içerir.
SparseFile Sıralı sabit Dosya seyrek bir dosyadır. Seyrek dosyalar genellikle verileri çoğunlukla sıfır olan büyük dosyalardır.
Sistem Sıralı sabit Dosya bir sistem dosyasıdır. Dosya, işletim sisteminin bir parçasıdır veya yalnızca işletim sistemi tarafından kullanılır.
Geçici Sıralı sabit Dosya geçicidir. Dosya sistemleri, verileri yığın depolama alanına geri boşaltmak yerine daha hızlı erişim için tüm verileri bellekte tutmaya çalışır. Geçici bir dosya, artık gerekli olmadığı anda uygulama tarafından silinmelidir.

PowerShell'de bu tür FlagsAttribute özniteliğine sahip System.IO.FileAttributes'tir.

4.2.6.4 Düzenli-İfade-Seçeneği türü

Bu uygulama tanımlı tür, birleştirilebilen aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Amaç
IgnoreCase Sıralı sabit Eşleşmenin büyük küçük harfe duyarsız olduğunu belirtir.
Hiç kimse Sıralı sabit Hiçbir seçeneğin ayarlı olmadığını belirtir.

Bir uygulama başka değerler sağlayabilir.

PowerShell'de bu tür System.Text.RegularExpressions.RegexOptions, özniteliği FlagsAttributeile birlikte. Aşağıdaki ek değerler tanımlanır: Compiled, CultureInvariant, ECMAScript, ExplicitCapture, IgnorePatternWhitespace, Multiline, RightToLeft, Singleline.

4.3 Başvuru türleri

4.3.1 Dizeler

Dize türünde bir değer, her biri UTF-16 kodlu 16 bitlik Unicode kod noktası içeren char türünde sıfır veya daha fazla karakterden oluşan değiştirilemez bir dizidir.

Tür dizesi aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Uzunluk Örnek Özelliği int (salt okunur) Dizedeki karakter sayısını alır
ToLower Örnek Yöntemi dizgi Küçük harf eşdeğerini içeren yeni bir dize oluşturur
ToUpper Örnek Yöntemi dizgi Büyük harf eşdeğerini içeren yeni bir dize oluşturur

PowerShell'de string, System.Stringile eşleşir.

4.3.2 Diziler

Tüm dizi türleri arraytüründen türetilir. Bu tür aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Uzunluk Örnek Özelliği (salt okunur) Int Dizideki öğe sayısı
Rütbe Örnek Özelliği (salt okunur) Int Dizideki boyut sayısı
Kopyala Statik Yöntem void/bkz. Amaç sütunu

Bir diziden diğerine öğe aralığını kopyalar. Kaynak kaynak dizi, hedef hedef dizi, sayı kopyalanacak öğe sayısı, sourceIndex ve destinationIndex ise kendi dizilerindeki başlangıç konumları olan dört sürüm vardır.

Copy(kaynak, hedef, int sayı)
Copy(kaynak, hedef, uzun sayı)
Kopyala(kaynak, kaynakDizin, hedef, hedefDizin, int miktar)
Copy(kaynak, kaynakIndeksi, hedef, hedefIndeksi, uzunluk sayısı)

GetLength Örnek Yöntemi (salt okunur) int/none

Belirli bir boyuttaki öğe sayısı

GetLength(int boyut)

Diziler hakkında daha fazla bilgi için bkz. §9.

PowerShell'de array, System.Arrayile eşleşir.

4.3.3 Karma Tablosu

Hashtable türü aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Sayı Örnek Özelliği Int Hashtable'daki anahtar/değer çiftlerinin sayısını alır
Anahtar Örnek Özelliği Uygulama tanımlı Tüm anahtarların bir koleksiyonunu alır
Değer Örnek Özelliği Uygulama tanımlı Tüm değerlerin bir koleksiyonunu alır
Kaldır Örnek Yöntemi boş/hiçbir Belirlenen anahtarı/değeri kaldırır

Hashtable'lar hakkında daha fazla bilgi için bkz. §10.

PowerShell'de Hashtable, System.Collections.Hashtableile eşleşir. Hashtable öğeleri DictionaryEntrytüründe bir nesnede depolanır ve Anahtarlar ve Değerler tarafından döndürülen koleksiyonlar ICollectiontüründedir.

4.3.4 Xml türü

Xml türü W3C Belge Nesne Modeli (DOM) Düzey 1 Çekirdeğini ve Çekirdek DOM Düzey 2'yi uygular. DOM, bir XML belgesinin bellek içi (önbellek) ağaç gösterimidir ve bu belgenin gezintisini ve düzenlenmesini sağlar. Bu tür, alt indis işlecini [] (§7.1.4.4) destekler.

PowerShell'de xml, System.Xml.XmlDocumentile eşleşir.

4.3.5 Regex türü

Tür regex, normal ifade işlemeyi desteklemek için makineler sağlar. Karşılık gelen bağımsız değişkeni normal bir ifade içerebilecek bir parametrenin türünü (§5.3) kısıtlamak için kullanılır.

PowerShell'de regex, System.Text.RegularExpressions.Regexile eşleşir.

4.3.6 Referans türü

Normalde parametreler değere göre komutlara geçirilir. Bir bağımsız değişkenin, bir değer türüne sahip olması durumunda, bu değerin bir kopyası aktarılır. Referans türünde bir bağımsız değişken olması durumunda, referansın bir kopyası geçirilir.

Tür referansı, bağımsız değişkenlerin komutlara başvuru yoluyla iletilmesine izin veren bir mekanizma sağlar, bu sayede komutlar bağımsız değişkenin değerini değiştirebilir. Tür referansı aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Değer Nesne özelliği (okuma-yazma) Başvurulmakta olan değerin türü. Başvurulmakta olan değeri alır/ayarlar.

Aşağıdaki işlev tanımını ve çağrısını göz önünde bulundurun:

function Doubler {
    param ([ref]$x) # parameter received by reference
    $x.Value *= 2.0 # note that 2.0 has type double
}

$number = 8 # designates a value of type int, value 8
Doubler([ref]$number) # argument received by reference
$number # designates a value of type double, value 8.0

$number türü kısıtlanmış olduğu durumu göz önünde bulundurun:

[int]$number = 8 # designates a value of type int, value 8
Doubler([ref]$number) # argument received by reference
$number # designates a value of type int, value 8

Gösterildiği gibi, hem bağımsız değişken hem de karşılık gelen parametre reftanımlanmalıdır.

PowerShell'de ref, System.Management.Automation.PSReferenceile eşleşir.

4.3.7 Betik engelleme türü

Tür scriptblock, tek bir birim olarak kullanılabilecek önceden derlenmiş bir betik metni bloğunu (§7.1.8) temsil eder. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Öznitelik Örnek özelliği (salt okunur) Öznitelik koleksiyonu Betik bloğunun özniteliklerini alır.
Dosya Örnek özelliği (salt okunur) dizgi Betik bloğunun tanımlandığı dosyanın adını alır.
Modül Örnek özelliği (salt okunur) uygulama tanımlı ([§4.5.12][§4.5.12]) Betik bloğunun tanımlandığı modül hakkında bilgi alır.
GetNewClosure İnstans metodu komut bloğu
/hiç kimse
Modüle bağlı bir betik bloğunu alır. Çağıranın bağlamındaki tüm yerel değişkenler modüle kopyalanır.
Çağırmak İnstans metodu Nesne/nesne[] koleksiyonu Betik bloğunu belirtilen bağımsız değişkenlerle çağırır ve sonuçları döndürür.
InvokeReturnAsIs İnstans metodu nesne/nesne[] Betik bloğunu belirtilen bağımsız değişkenlerle çağırır ve oluşturulan nesneleri döndürür.
Yaratmak Statik yöntem komut bloğu
/dizi
Belirtilen betiği içeren yeni bir scriptblock nesnesi oluşturur.

PowerShell'de scriptblock, System.Management.Automation.ScriptBlockile eşleşir. Invoke bir PSObjectkoleksiyonu döndürür.

4.3.8 Matematik türü

Tür math, matematiksel hesaplamalarda yararlı olan bazı sabitlere ve yöntemlere erişim sağlar. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
E Statik özellik (salt okunur) çift Doğal logaritmik taban
Statik özellik (salt okunur) çift Dairenin çevresinin çapına oranı
Karın kasları Statik yöntem sayısal/sayısal Mutlak değer (dönüş türü, geçirilen bağımsız değişkenin türüyle aynıdır)
Acos Statik yöntem çift / çift Kosinüsü belirtilen sayı olan açı
Asin Statik yöntem çift / çift Sinüsü belirtilen sayı olan açı
Atan Statik yöntem çift / çift Tanjant değeri belirtilen sayı olan açı
Atan2 Statik yöntem çift / çift y, çift x Tanjantı x ve y olan iki sayının bölümünün açısı.
Tavan Statik yöntem

ondalık / ondalık

çift / çift

belirtilen sayıdan büyük veya buna eşit en küçük tamsayı
Çünkü Statik yöntem çift / çift Belirtilen açının kosinüsü
Cosh Statik yöntem çift / çift Belirtilen açının hiperbolik kosinüsü
Exp Statik yöntem çift / çift belirtilen güce yükseltilmiş e
Zemin Statik yöntem

ondalık / ondalık

çift / çift

Belirtilen sayıdan küçük veya buna eşit en büyük tamsayı
Kayıt Statik yöntem

çift sayı numara

çift / çift sayı, çift taban

Taban e veya taban kullanan sayının logaritması
Logaritma10 Statik yöntem çift / çift Belirtilen sayının 10 tabanında logaritması
Max Statik yöntem sayısal/sayısal İki belirtilen sayıdan daha büyük olanı (dönüş türü, geçirilen argümanların türüyle aynıdır)
Min Statik yöntem sayısal/sayısal, sayısal Belirtilen iki sayıdan daha küçük olanı (dönüş türü, geçirilen argümanların türüyle aynıdır)
Pow Statik yöntem çift / çift x, çift y Belirtilen sayı x, belirtilen üs y üzerine çıkarılmıştır.
Günah Statik yöntem çift / çift Belirtilen açının sinüsü
Sinh Statik yöntem çift / çift Belirtilen açının hiperbolik sinüsü
Karekök Statik yöntem çift / çift Belirtilen sayının karekökü
Taba rengi Statik yöntem çift / çift Belirtilen açının tanjant değeri
Tanh Statik yöntem çift / çift Belirlenen açının hiperbolik tanjantı

PowerShell'de Math, System.Mathile eşleşir.

4.3.9 Sıralı tür

tür ordered yalnızca dönüştürmeler için kullanılan sahte bir türdür.

4.3.10 Pscustomobject türü

tür pscustomobject yalnızca dönüştürmeler için kullanılan sahte bir türdür.

4.4 Genel türler

Çeşitli programlama dilleri ve ortamları, özelleştirilebilir türler sağlayabilir. Bu türlerin çoğukapsayıcı türleri olarak adlandırılır, bunun örnekleri başka türde nesneler içerebildiğinden. Değerlerin üzerine eklenip çıkarılabileceği bir yığını temsil eden Stack adlı bir türü göz önünde bulundurun. Genellikle, bir yığının kullanıcısı bu yığında yalnızca bir tür nesne depolamak ister. Ancak, dil veya ortam tür özelleştirmeyi desteklemiyorsa, yalnızca farklı tür öğeleriyle aynı görevi yerine getiren Stack türünün birden fazla farklı varyantı uygulanmalıdır.

Tür özelleştirmesi, genel tür uygulanmasına olanak tanır, böylece kullanıldığında bazı tür alt kümelerini işlemek için kısıtlanabilir. Örneğin

  • Dizeleri tutmak için özelleştirilmiş genel bir yığın türü Stack[string]olarak yazılabilir.
  • İlişkili dize değerlerine sahip int anahtarlarını tutmak için özelleştirilmiş genel bir sözlük türü Dictionary[int,string]olarak yazılabilir.
  • Dize yığını Stack[Stack[string]]olarak yazılabilir.

PowerShell herhangi bir yerleşik genel tür tanımlamasa da, konak ortamı tarafından sağlanırsa bu tür türleri kullanabilir. §7.1.10söz dizimine bakın.

Yukarıda önerilen Stack[string] türünün tam adı System.Collections.Generic.Stack[string]. Yukarıda önerilen Dictionary[int,string] türünün tam adı System.Collections.Generic.Dictionary[int,string].

4.5 Anonim türler

Bazı durumlarda, PowerShell'in bir uygulaması belirli bir türdeki nesneleri oluşturur ve bu nesnelerin betik tarafından erişilebilen üyeleri vardır. Ancak, kullanılmaları için erişilebilir üyelerin yeterince belirtilmiş olması şartıyla, bu türlerin gerçek adının belirtilmesine gerek yoktur. Başka bir ifadeyle, betikler bu türlerdeki nesneleri kaydedebilir ve aslında bu türlerin adlarını bilmeye gerek olmadan üyelerine erişebilir. Aşağıdaki alt bölümler bu türleri belirtir.

4.5.1 Sağlayıcı açıklama türü

Bu tür bir sağlayıcının durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Sürücüler Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.2) Sürücü açıklama nesnelerinin koleksiyonu
İsim Örnek özelliği (salt okunur) dizgi Sağlayıcının adı

PowerShell'de bu tip System.Management.Automation.ProviderInfo.

4.5.2 Sürücü açıklama türü

Bu tür, bir sürücünün durumunu tanımlar. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Mevcut Konum Nesne özelliği (okuma-yazma) dizgi Sürücünün mevcut çalışma yeri (§3.1.4)
Açıklama Nesne özelliği (okuma-yazma) dizgi Sürücünün açıklaması
İsim Örnek özelliği (salt okunur) dizgi Sürücünün adı
Kök Örnek özelliği (salt okunur) dizgi Sürücünün adı

PowerShell'de bu tip System.Management.Automation.PSDriveInfo.

4.5.3 Değişken açıklama türü

Bu tür bir değişkenin durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Öznitelik Örnek özelliği (salt okunur) Uygulama tanımlı Öznitelik koleksiyonu
Açıklama Nesne özelliği (okuma-yazma) dizgi New-Variable veya Set-Variable cmdlet'leri aracılığıyla değişkene atanan açıklama.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.12) Bu değişkenin dışarı aktarıldığı modül
ModülAdı Örnek özelliği (salt okunur) dizgi Bu değişkenin tanımlandığı modül
İsim Örnek özelliği (salt okunur) dizgi Değişken PowerShell dilinde veya New-Variable ve Set-Variable cmdlet'leri aracılığıyla oluşturulduğunda değişkenine atanan ad.
Seçenekler Nesne özelliği (okuma-yazma) dizgi New-Variable ve Set-Variable cmdlet'leri aracılığıyla değişkene atanan seçenekler.
Değer Nesne özelliği (okuma-yazma) nesne Değişkene PowerShell dilinde veya New-Variable ve Set-Variable cmdlet'leri aracılığıyla atandığında atanan değer.

PowerShell'de bu tip System.Management.Automation.PSVariable.

Windows PowerShell: Öznitelik koleksiyonunun türü System.Management.Automation.PSVariableAttributeCollection'dır.

4.5.4 Takma ad açıklama türü

Bu tür bir diğer adın durumunu tanımlar. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
KomutTürü Örnek özelliği (salt okunur) Uygulama tanımlı Eşit olmak için "Alias" ile karşılaştırılmalıdır.
Tanım Örnek özelliği (salt okunur) dizgi New-Alias veya Set-Alias cmdlet'leri aracılığıyla diğer adın atandığı komut veya alias.
Açıklama Nesne özelliği (okuma-yazma) dizgi New-Alias veya Set-Alias cmdlet'leri aracılığıyla diğer adlara atanan açıklama.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.12) Bu takma adın ihrac edildiği modül
ModülAdı Örnek özelliği (salt okunur) dizgi Bu diğer adın tanımlandığı modül
İsim Örnek özelliği (salt okunur) dizgi Cmdlet'ler New-Alias veya Set-Alias aracılığıyla oluşturulduğunda takma ada atanan ad.
Seçenekler Nesne özelliği (okuma-yazma) dizgi New-Alias New-Alias veya Set-Alias cmdlet'leri aracılığıyla takma adlara atanan seçenekler.
Çıktı Türü Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Diğer adın başvurduğu komut tarafından üretilen çıktı değerlerinin türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Komutun parametreleri.
ParametreSetleri Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon komutuyla ilişkili parametre kümeleri hakkında bilgi.
Başvurulan Komut Örnek özelliği (salt okunur) Uygulama tanımlı Bu takma adın hemen başvurduğu komutla ilgili bilgiler.
ÇözümlenmişKomut Örnek özelliği (salt okunur) Uygulama tanımlı Nihayet çözümlenen diğer adın bağlı olduğu komut hakkında bilgiler.

PowerShell'de bu tip System.Management.Automation.AliasInfo.

4.5.5 Çalışma konumu açıklama türü

Bu tür, çalışma konumunun durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Sürüş Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.2) Sürücü tanım nesnesi
Yol Örnek özelliği (salt okunur) dizgi Çalışma konumu
Sağlayıcı Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.1) Sağlayıcı
ProviderPath Örnek özelliği (salt okunur) dizgi Sağlayıcının mevcut yolu

Çalışma konumları yığını, yukarıda açıklandığı gibi bir çalışma konumu nesneleri koleksiyonudur.

PowerShell'de, geçerli bir çalışma konumu System.Management.Automation.PathInfotüründe bir nesneyle temsil edilir. Çalışma konumları yığını, System.Management.Automation.PathInfoStack nesneleri koleksiyonu olan PathInfotüründe bir nesneyle temsil edilir.

4.5.6 Ortam değişkeni açıklama türü

Bu tür bir ortam değişkeninin durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
İsim Nesne özelliği (okuma-yazma) dizgi Ortam değişkeninin adı
Değer Nesne özelliği (okuma-yazma) dizgi Ortam değişkeninin değeri

PowerShell'de bu tip System.Collections.DictionaryEntry. Değişkenin adı sözlük anahtarıdır. Ortam değişkeninin değeri sözlük değeridir. Adı, AliasProperty'ne eşit olan bir .

4.5.7 Uygulama açıklama türü

Bu tür bir uygulamanın durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
KomutTürü Örnek özelliği (salt okunur) Uygulama tanımlı "Uygulama" ile eşit olarak karşılaştırılmalıdır.
Tanım Örnek özelliği (salt okunur) dizgi Uygulamanın açıklaması.
Uzantı Nesne özelliği (okuma-yazma) dizgi Uygulama dosyasının uzantısı.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.12) Bu komutu tanımlayan modül.
ModülAdı Örnek özelliği (salt okunur) dizgi komutunu tanımlayan modülün adı.
İsim Örnek özelliği (salt okunur) dizgi Komutun adı.
Çıktı Türü Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon komutu tarafından sunulan değer çıkışlarının türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Komutun parametreleri.
ParametreSetleri Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon komutuyla ilişkili parametre kümeleri hakkında bilgi.
Yol Örnek özelliği (salt okunur) dizgi Uygulama dosyasının yolunu alır.

PowerShell'de bu tip System.Management.Automation.ApplicationInfo.

4.5.8 Cmdlet açıklama türü

Bu tip, bir cmdlet'in durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
KomutTürü Örnek özelliği (salt okunur) Uygulama tanımlı "Cmdlet" ile eşit olmalı.
Varsayılan Parametre Seti Örnek özelliği (salt okunur) Uygulama tanımlı PowerShell, sağlanan bağımsız değişkenlere göre hangi parametre kümesinin kullanılacağını belirleyemediğinde kullanılan varsayılan parametre kümesidir.
Tanım Örnek özelliği (salt okunur) dizgi Cmdlet'in açıklaması.
Yardım Dosyası Nesne özelliği (okuma-yazma) dizgi Cmdlet için Yardım dosyasının yolu.
UygulamaTipi Nesne özelliği (okuma-yazma) Uygulama tanımlı cmdlet'i uygulayan tür.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.12) Bu cmdlet'i tanımlayan modül.
ModülAdı Örnek özelliği (salt okunur) dizgi cmdlet'ini tanımlayan modülün adı.
İsim Örnek özelliği (salt okunur) dizgi Cmdlet'in adı.
İsim Örnek özelliği (salt okunur) dizgi Cmdlet'in isim adı.
Çıktı Türü Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon cmdlet tarafından çıktısı verilen değerlerin türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon cmdlet'in parametreleri.
ParametreSetleri Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon cmdlet'iyle ilişkili parametre kümeleri hakkında bilgi.
Fiil Örnek özelliği (salt okunur) dizgi Cmdlet'in fiil adı.
PSSnapIn Örnek özelliği (salt okunur) Uygulama tanımlı Windows PowerShell: Cmdlet'i kaydetmek için kullanılan Windows PowerShell ek bileşeni hakkında bilgiler.

PowerShell'de bu tip System.Management.Automation.CmdletInfo.

4.5.9 Dış betik açıklama türü

Bu tür, bir dış betiğin (PowerShell tarafından doğrudan yürütülebilir ancak yerleşik olmayan) durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
KomutTürü Örnek özelliği (salt okunur) Uygulama tanımlı "ExternalScript" ile eşit olarak karşılaştırılmalıdır.
Tanım Örnek özelliği (salt okunur) dizgi Bir betiğin tanımı.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.12) Bu betiği tanımlayan modül.
ModülAdı Örnek özelliği (salt okunur) dizgi Betiği tanımlayan modülün adı.
İsim Örnek özelliği (salt okunur) dizgi Betiğin adı.
OriginalEncoding Örnek özelliği (salt okunur) Uygulama tanımlı Betiğin karakterlerini baytlara dönüştürmek için kullanılan özgün kodlama.
Çıktı Türü Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Betiğin değer çıktısı türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Betiğin parametreleri.
ParametreSetleri Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Betikle ilişkilendirilmiş parametre kümeleri hakkında bilgi.
Yol Örnek özelliği (salt okunur) dizgi Betik dosyasına giden yol.
ScriptBlock Örnek özelliği (salt okunur) komut bloğu Dış komut dosyası.
ScriptContents Örnek özelliği (salt okunur) dizgi Betiğin özgün içeriği.

PowerShell'de bu tip System.Management.Automation.ExternalScriptInfo.

4.5.10 İşlev açıklama türü

Bu tür bir işlevin durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
CmdletBinding Örnek özelliği (salt okunur) Bool İşlevin derlenmiş cmdlet'lerin kullandığı parametre bağlamasının aynısını kullanıp kullanmadığını gösterir (bkz. §12.3.5).
KomutTürü Örnek özelliği (salt okunur) Uygulama tanımlı Bu nesnelerden hangisini temsil ettiği görmek için "İşlev" veya "Filtre" ile eşitlik için karşılaştırılabilir.
Varsayılan Parametre Seti Örnek özelliği (salt okunur) dizgi Belirlenemediği durumlarda kullanılacak parametre kümesini belirtir (bkz. §12.3.5).
Tanım Örnek özelliği (salt okunur) dizgi ScriptBlock'un dize sürümü
Açıklama Nesne özelliği (okuma-yazma) dizgi İşlevin açıklaması.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (§4.5.12) Bu işlevin dışarı aktarıldığı modül
ModülAdı Örnek özelliği (salt okunur) dizgi Bu işlevin tanımlandığı modül
İsim Örnek özelliği (salt okunur) dizgi İşlevin adı
Seçenekler Nesne özelliği (okuma-yazma) Uygulama tanımlı İşlevin kapsam seçenekleri (§3.5.4).
Çıktı Türü Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Değer çıkışlarının türlerini sırasıyla belirtir (bkz. §12.3.6).
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Parametre adlarını sırayla belirtir. İşlev bir cmdlet gibi davranırsa (yukarıdaki CmdletBinding bölümüne bakın), ortak parametreleri koleksiyonun sonuna eklenir.
ParametreSetleri Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon komutuyla ilişkili parametre kümeleri hakkında bilgi. Her parametre için, sonuç parametre adını ve türünü gösterir ve konuma veya anahtar parametresine göre parametrenin zorunlu olup olmadığını gösterir. İşlev bir cmdlet gibi davranırsa (yukarıdaki CmdletBinding bölümüne bakın), ortak parametreleri koleksiyonun sonuna eklenir.
ScriptBlock Örnek özelliği (salt okunur) scriptblock (§4.3.6) İşlevin gövdesi

PowerShell'de bu tip System.Management.Automation.FunctionInfo.

  • CommandType, System.Management.Automation.CommandTypes türündedir.
  • Options, System.Management.Automation.ScopedItemOptions türündedir.
  • OutputType, System.Collections.ObjectModel.ReadOnlyCollection``1[[System.Management.Automation.PSTypeName,System.Management.Automation]] türündedir.
  • Parameters, System.Collections.Generic.Dictionary``2[[System.String,mscorlib],[System.Management.Automation.ParameterMetadata,System.Management.Automation]] türündedir.
  • ParameterSets, System.Collections.ObjectModel.ReadOnlyCollection``1[[System.Management.Automation.CommandParameterSetInfo,System.Management.Automation]] türündedir.
  • Görünürlük türü System.Management.Automation.SessionStateEntryVisibility.
  • PowerShell ayrıca Visibilityadlı bir özelliğe sahiptir.

4.5.11 Filtre açıklama türü

Bu tür bir filtrenin durumunu kapsüller. İşlev açıklama türüyle (§4.5.10) aynı erişilebilir üye kümesine sahiptir.

PowerShell'de bu tip System.Management.Automation.FilterInfo. System.Management.Automation.FunctionInfo (§4.5.11) ile aynı özellikler kümesine sahiptir.

4.5.12 Modül açıklama türü

Bu tür bir modülün durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Açıklama Nesne özelliği (okuma-yazma) dizgi Modülün açıklaması (manifest tarafından ayarlanır)
ModülTürü Örnek özelliği (salt okunur) Uygulama tanımlı Modülün türü (Bildirim, Betik veya İkili)
İsim Örnek özelliği (salt okunur) dizgi Modülün adı
Yol Örnek özelliği (salt okunur) dizgi Modülün yolu

PowerShell'de bu tip System.Management.Automation.PSModuleInfo. ModuleType türü System.Management.Automation.ModuleType'dir.

4.5.13 Özel nesne açıklama türü

Bu tür, özel bir nesnenin durumunu kapsüller. Erişilebilir üyesi yok.

PowerShell'de bu tip System.Management.Automation.PSCustomObject. Import-Module ve New-Object cmdlet'leri bu tür bir nesne oluşturabilir.

4.5.14 Komut açıklaması türü

Otomatik değişken $PSCmdlet, yürütülen cmdlet'i veya işlevi temsil eden bir nesnedir. Bu nesnenin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
ParametreSetiAdı Örnek özelliği (salt okunur) dizgi Geçerli parametre kümesinin adı (bkz. ParameterSetName)
DevamEtmeli İnstans metodu

Aşırı yüklü

/bool

Kullanıcıdan bir işlemin onaylanmasını istemektedir.
ShouldProcess İnstans metodu

Aşırı yüklü

/bool

İşlem gerçekleştirilmeden önce kullanıcıdan onay isteğinde bulunur.

PowerShell'de bu tür System.Management.Automation.PSScriptCmdlet'tir.

4.5.15 Hata kaydı açıklama türü

Otomatik değişken $Error, son hataları temsil eden bir hata kayıtları koleksiyonu içerir (§3.12). Bu koleksiyonun türü belirtilmemiş olsa da, tek tek hata kayıtlarına erişmek için indislemeyi destekler.

PowerShell'de koleksiyon türü System.Collections.ArrayList. Koleksiyondaki bireysel bir hata kaydının türü System.Management.Automation.ErrorRecord'dır. Bu tür aşağıdaki genel özelliklere sahiptir:

  • CategoryInfo - Hatanın kategorisi hakkında bilgi alır.
  • ErrorDetails - Değiştirme hata iletisi gibi daha ayrıntılı hata bilgilerini alır ve ayarlar.
  • Özel Durum - Bu hata kaydıyla ilişkili özel durumu alır.
  • FullyQualifiedErrorId - Bu hata kaydı için tam hata tanımlayıcısını alır.
  • InvocationInfo - Hata oluştuğunda çağrılan komut hakkında bilgi alır.
  • PipelineIterationInfo - Bu hata kaydı oluşturulduğunda işlem hattının durumunu alır
  • TargetObject - Hata oluştuğunda işlenen nesneyi alır.

4.5.16 Numaralandırıcı açıklama türü

Koleksiyonlar için bir dizi değişken numaralandırıcıdır (§4). Otomatik değişken $foreach, herhangi bir foreach deyimi için oluşturulan numaralandırıcıdır. $input otomatik değişkeni, işlem hattından bir işleve teslim edilen koleksiyonun numaralandırıcısıdır. Otomatik değişken $switch, herhangi bir switch deyimi için oluşturulan numaralandırıcıdır.

Bir numaralandırıcının türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Geçerli Örnek özelliği (salt okunur) nesne Koleksiyondaki geçerli öğeyi alır. Numaralandırıcı şu anda koleksiyonun bir öğesinde konumlandırılmadıysa, davranış uygulama tanımlıdır.
Sonrakine Geç İnstans metodu Yok/bool Numaralandırıcıyı koleksiyonun sonraki öğesine ilerletir. Numaralandırıcı bir sonraki öğeye başarıyla ilerletildiyse $true döndürür; Numaralandırıcının koleksiyonun sonunu geçip geçmediğini $false.

PowerShell'de bu üyeler, aşağıda tanımlanan türler tarafından uygulanan System.IEnumeratorarabiriminde tanımlanır. Numaralandırıcı şu anda koleksiyonun bir öğesinde konumlandırılmadıysa, InvalidOperationException türünde bir özel durum oluşturulur. $foreach için, bu tür System.Array+SZArrayEnumerator. $input için, bu tür System.Collections.ArrayList+ArrayListEnumeratorSimple. $switch için, bu tür System.Array+SZArrayEnumerator.

4.5.17 Dizin açıklama türü

New-Item cmdlet'i, FileSystem dizinleri de dahil olmak üzere çeşitli türlerde öğe oluşturabilir. Dizin açıklaması nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Öznitelik Nesne özelliği (okuma-yazma) Uygulama tanımlı (§4.2.6.3) Dizin nesnesinin bir veya daha fazla özniteliğini alır veya ayarlar.
Oluşturma Zamanı Nesne özelliği (okuma-yazma) Uygulama tanımlı (§4.5.19) Dizin nesnesinin oluşturma zamanını alır ve ayarlar.
Uzantı Örnek özelliği (salt okunur) dizgi Dizin adının uzantı bölümünü alır.
Ad Soyad Örnek özelliği (salt okunur) dizgi Dizinin tam yolunu alır.
Son Yazma Zamanı Nesne özelliği (okuma-yazma) Uygulama tanımlı (§4.5.19) Dizinin son yazılma zamanını alır ve ayarlar.
İsim Örnek özelliği (salt okunur) dizgi Dizinin adını alır.

PowerShell'de bu tip System.IO.DirectoryInfo. Öznitelikleri özelliğinin türü System.IO.FileAttributes.

4.5.18 Dosya açıklama türü

cmdlet New-Item, FileSystem dosyaları da dahil olmak üzere çeşitli türlerde öğeler oluşturabilir. Dosya açıklaması nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Öznitelik Nesne özelliği (okuma-yazma) Uygulama tanımlı (§4.2.6.3) Dosya nesnesinin bir veya daha fazla özniteliğini alır veya ayarlar.
Temel Ad Örnek özelliği (salt okunur) dizgi Uzantı hariç dosyanın adını alır.
Oluşturma Zamanı Nesne özelliği (okuma-yazma) Uygulama tanımlı (§4.5.19) Dosya nesnesinin oluşturma zamanını alır ve ayarlar.
Uzantı Örnek özelliği (salt okunur) dizgi Dosya adının uzantı bölümünü alır.
Ad Soyad Örnek özelliği (salt okunur) dizgi Dosyanın tam yolunu alır.
Son Yazma Zamanı Nesne özelliği (okuma-yazma) Uygulama tanımlı (§4.5.19) Dosyanın en son yazıldığı zamanı alır ve ayarlar.
Uzunluk Örnek özelliği (salt okunur) uzun Dosyanın boyutunu bayt cinsinden alır.
İsim Örnek özelliği (salt okunur) dizgi Dosyanın adını alır.
SürümBilgisi Örnek özelliği (salt okunur) Uygulama tanımlı Windows PowerShell: Bu ScriptProperty, dosya için System.Diagnostics.FileVersionInfo döndürür.

PowerShell'de bu tip System.IO.FileInfo.

4.5.19 Date-Time açıklama türü

Tarih-saat açıklama nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Gün Örnek özelliği (salt okunur) Int Bu örnek tarafından temsil edilen ayın gün bileşenini alır.
Saat Örnek özelliği (salt okunur) Int Bu örnek tarafından temsil edilen tarihin saat bileşenini alır.
Dakika Örnek özelliği (salt okunur) Int Bu örnek tarafından temsil edilen tarihin dakika bileşenini alır.
Ay Örnek özelliği (salt okunur) Int Bu örnek tarafından temsil edilen tarihin ay bileşenini alır.
İkinci Örnek özelliği (salt okunur) Int Bu örnek tarafından temsil edilen tarihin saniye bileşenini alır.
Yıl Örnek özelliği (salt okunur) Int Bu örnek tarafından temsil edilen tarihin yıl bileşenini alır.

Bu tür bir nesne Get-Datecmdlet'i tarafından oluşturulabilir.

PowerShell'de bu tip System.DateTime.

4.5.20 Group-Info açıklama türü

grup bilgisi açıklama nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Sayı Örnek özelliği (salt okunur) Int Gruptaki öğelerin sayısını alır.
Grup Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Grubun öğelerini alır.
İsim Örnek özelliği (salt okunur) dizgi Grubun adını alır.
Değer Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Grubun öğelerinin değerlerini alır.

Bu tür bir nesne,Group-Object cmdlet'i tarafından oluşturulabilir.

PowerShell'de bu tip Microsoft.PowerShell.Commands.GroupInfo.

4.5.21 Genel-Measure-Info açıklama türü

generic-measure-info açıklama nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Ortalama Örnek özelliği (salt okunur) çift Ölçülen özelliklerin değerlerinin ortalamasını alır.
Sayı Örnek özelliği (salt okunur) Int Belirtilen özelliklere sahip nesne sayısını alır.
Maksimum Örnek özelliği (salt okunur) çift Belirtilen özelliklerin en büyük değerini alır.
Asgari Örnek özelliği (salt okunur) çift Belirtilen özelliklerin en düşük değerini alır.
Mülk Örnek özelliği (salt okunur) dizgi Ölçülecek özelliği alır.
Toplam Örnek özelliği (salt okunur) çift Belirtilen özelliklerin değerlerinin toplamını alır.

Bu tür bir nesne, Measure-Objectcmdlet'i tarafından oluşturulabilir.

PowerShell'de bu tip Microsoft.PowerShell.Commands.GenericMeasureInfo.

4.5.22 Metin-Measure-Info açıklama türü

metin bilgisi açıklama nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Karakter Örnek özelliği (salt okunur) Int Hedef nesnedeki karakter sayısını alır.
Satır Örnek özelliği (salt okunur) Int Hedef nesnedeki satır sayısını alır.
Mülk Örnek özelliği (salt okunur) dizgi Ölçülecek özelliği alır.
Kelime Örnek özelliği (salt okunur) Int Hedef nesnedeki sözcük sayısını alır.

Bu tür bir nesne Measure-Objectcmdlet'i tarafından oluşturulabilir.

PowerShell'de bu tip Microsoft.PowerShell.Commands.TextMeasureInfo.

4.5.23 Kimlik bilgisi türü

Daha sonra bir kimlik bilgisi nesnesi çeşitli güvenlik işlemlerinde kullanılabilir. Kimlik bilgisi nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Parola Örnek özelliği (salt okunur) Uygulama tanımlı Parolayı alır.
Kullanıcı adı Örnek özelliği (salt okunur) dizgi Kullanıcı adını alır.

Bu tür bir nesne get-credentialcmdlet'i tarafından oluşturulabilir.

PowerShell'de bu tip System.Management.Automation.PSCredential.

4.5.24 Yöntem belirleyici türü

Yöntem belirleyici türü, uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Çağırmak İnstans metodu nesne/değişken numarası ve türü Belirsiz sayıda argüman alır ve bu argümanları geçirerek üstteki yöntem tanımlayıcısının başvurduğu yöntemi dolaylı olarak çağırır.

Bu türdeki bir nesne, çağrı ifadesi (§7.1.3) ile oluşturulabilir.

PowerShell'de bu tür System.Management.Automation.PSMethod'dir.

4.5.25 Üye tanım türü

Bu tür bir üyenin tanımını kapsüller. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye Türü Tür Amaç
Tanım Örnek özelliği (salt okunur) dizgi Üyenin tanımını alır.
Üye Tipi Örnek özelliği (salt okunur) Uygulama tanımlı Üyenin PowerShell türünü alır.
İsim Örnek özelliği (salt okunur) dizgi Üyenin adını getirir.
TürAdı Örnek özelliği (salt okunur) dizgi Üyenin tür adını alır.

PowerShell'de bu tip Microsoft.PowerShell.Commands.MemberDefinition.

4.6 Tip uzantısı ve uyarlaması

PowerShell uygulaması, her birikendi temel üyeleri kümesini içeren bir çekirdek tür ailesi (bu bölümde belgelenmiştir) içerir. Bu üyeler yöntem veya özellik olabilir ve örnek veya statik üyeler olabilir. Örneğin, tür dizesinin (§4.3.1) temel üyeleri, Örnek özelliği Length ve ToLower ve ToUpper örnek yöntemleridir.

Bir nesne oluşturulduğunda, nesnenin türünün tüm örnek özelliklerini içerir ve bu nesne üzerinde bu türdeki örnek yöntemleri çağrılabilir. Bir nesne, çalışma zamanında örnek üyelerinin eklenmesiyle özelleştirilebilir. Sonuç, özel nesnesiolarak adlandırılır. Bir örneğe eklenen tüm üyeler yalnızca o örneğin ömrü boyunca var olur; aynı çekirdek türünün diğer örnekleri etkilenmez.

Bir türün temel üye kümesi, aşağıdaki üye türlerinin eklenmesiyle artırılabilir:

  • uyarlanmış üyeler, çoğu detayı belirtilmeyen Genişletilmiş Tür Sistemi (ETS) aracılığıyla.
  • genişletilmiş üyeler,cmdlet'i aracılığıyla Add-Member.

PowerShell'de, genişletilmiş üyeler types.ps1xml dosyalar aracılığıyla da eklenebilir. Uyarlanmış ve genişletilmiş üyeler sentetiküyelerolarak adlandırılır.

ETS, tüm PowerShell nesnelerine şu üyeleri ekler: psbase, psadapted, psextendedve pstypenames. Bu üyeler hakkında daha fazla bilgi için Force ve View parametrelerini Get-Member cmdlet'inde inceleyin.

Örnek bir üye, aynı isme sahip genişletilmiş ve/veya uyarlanmış bir üyeyi gizleyebilir ve genişletilmiş bir üye de uyarlanmış bir üyeyi gizleyebilir. Bu gibi durumlarda, psadapted ve psextended kümeleri, bu gizli üyelere erişmek için kullanılabilir.

Eğer types.ps1xml, Destekler adlı bir üye belirtiyorsa, obj.psextended sadece o üyeye erişim sağlamak için çalışır ve Add-Memberaracılığıyla eklenen herhangi bir üyeye erişim sağlamaz.

Yeni bir M üyesine sahip özel nesne oluşturmanın üç yolu vardır:

  1. Bu yaklaşım, bir veya daha fazla NoteProperty üyesi eklemek için kullanılabilir.

    $x = New-Object PSObject -Property @{M = 123}
    
  2. Bu yaklaşım NoteProperty veya ScriptMethod üyeleri eklemek için kullanılabilir.

    $x = New-Module -AsCustomObject {$M = 123 ; Export-ModuleMember --Variable M}
    
  3. Bu yaklaşım, herhangi bir üye türünü eklemek için kullanılabilir.

    $x = New-Object PSObject
    Add-Member -InputObject $x -Name M -MemberType NoteProperty -Value 123
    

PSObject tüm PowerShell türlerinin temel türüdür.