Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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
intdeğ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ı) |
| 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 |
| Pİ | 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ğu
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), |
| 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), |
| 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.CommandTypestüründedir. -
Options,System.Management.Automation.ScopedItemOptionstü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-Date
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
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-credential
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
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:
Bu yaklaşım, bir veya daha fazla NoteProperty üyesi eklemek için kullanılabilir.
$x = New-Object PSObject -Property @{M = 123}Bu yaklaşım NoteProperty veya ScriptMethod üyeleri eklemek için kullanılabilir.
$x = New-Module -AsCustomObject {$M = 123 ; Export-ModuleMember --Variable M}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.
PowerShell