4. tür

PowerShell 'de her bir değer bir türe sahiptir ve türler iki ana kategoriden birine ayrılır: değer türleri ve başvuru türleri. Değer türlerinin tipik olan türünü int göz önünde bulundurun. Türünde int bir değer tamamen kendi içinde bulunur; bu değeri temsil etmek için gereken tüm bitleri bu değerde saklanır ve bu değer içindeki tüm bit desenler, türü için geçerli bir değeri temsil eder. Şimdi, başvuru türlerinin tipik bir dizi türünü int[] göz önünde bulundurun. Yani, $null bir dizi türünün adı, aslında Array öğelerini içeren bir nesneye ya da değeri olan null başvuruya sahip olabilir. İki tür kategorisi arasındaki önemli ayrım en iyi şekilde, atama sırasında anlamlarında farklılıklara göre 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örebilmemiz için, bir başvuru türü değerinin atanması basit bir kopyalama içerir; diğer bir deyişle, gerçek değeri yerine nesnesine başvurunun bir kopyasıdır. Bunun aksine, derin bir kopya nesnenin bir kopyasını oluşturmak için de gereklidir.

Sayısal bir tür, tamsayı veya kesirli değerlerin gösterimine izin veren ve bu değerler üzerinde aritmetik işlemleri destekleyen bir sayıdır. Sayısal türler kümesi, Integer (§ 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. Uygulama, başka sayısal türler (işaretli bayt, işaretsiz tamsayı ve diğer boyutlardaki tamsayılar gibi) sağlayabilir.

Koleksiyon , aynı türde olmayan bir veya daha fazla ilgili öğe grubudur. Koleksiyon türleri örnekleri diziler, yığınlar, kuyruklar, listeler ve karma tablolardır. Bir program, bir koleksiyondaki öğeler üzerinde Listeleme (veya yineleyebilir), her bir öğeye tek seferde erişim elde edebilir. Bunu gerçekleştirmenin yaygın yolları foreach ifadesi (§ 8.4.4) ve ForEach-Object cmdlet 'iyle birlikte bulunur. Bir Numaralandırıcı temsil eden nesnenin türü § 4.5.16içinde açıklanmaktadır.

Bu bölümde, belirli bir türün erişilebilir üyelerini listeeden tablolar vardır. Yöntemler için tür şu biçimde 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, Int16 UInt32 UInt16 ,, ve UInt64 tüm ad alanı sisteminde bulunur. SByte

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ı arabirimlerini ICollection , IComparer IList IEnumerable IDictionary ,,,, ve IDictionaryEnumerator genel eşdeğerlerini uygular.

4,1 özel türler

4.1.1 void türü

Bu tür örneği oluşturulamıyor. Atama işlecini (§ 7.2.9) kullanarak açıkça bir değeri atmak için bir yol sağlar.

4.1.2 null türü

Null türünde bir örnek, $null (§ 2.3.2.2) otomatik değişkeni, null değeri olarak da bilinir. Bu değer, başvuru bağlamlarında "nothingyetme" ifade etmek için bir yol sağlar. Bu türün özellikleri belirtilmedi.

4.1.3 nesne türü

Null türü (§ 4.1.2) hariç olmak üzere PowerShell içindeki her tür doğrudan veya dolaylı olarak tür nesnesinden türetilir, bu nedenle nesne, tüm null olmayan türlerin en son temel türüdür. Türü nesne için kısıtlanmış bir değişken (§ 5,3), herhangi bir türde bir değer içerebildiği için aslında hiçbir şekilde kısıtlanmaz.

4,2 değer türleri

4.2.1 Boolean

Boolean türü bool . Bu türden yalnızca iki değer vardır, false ve true, otomatik değişkenlerle $false temsil edilir ve $true sırasıyla (§ 2.3.2.2).

PowerShell 'de, bool ile System.Boolean eşlenir.

4.2.2 karakteri

Bir karakter değeri char türünde, UTF-16 kodlu 16 bit Unicode kod noktasını saklayabilen bir tür karakterdir.

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

Üye Üye türü Tür Amaç
Değerini Static özelliği (salt okunurdur) char Char türünde olası en büyük değer
MinValue Static özelliği (salt okunurdur) char Char türünde olası en küçük değer
IsControl Statik yöntem bool/karakter Karakterin bir denetim karakteri olup olmadığını sınar
IsDigit Statik yöntem bool/karakter Karakter ondalık sayı ise sınar
IsLetter Statik yöntem bool/karakter Karakterin alfabetik bir harf olup olmadığını sınar
Iletterordigit Statik yöntem bool/karakter Karakter ondalık sayı veya alfabetik bir harf ise test eder
IsLower Statik yöntem bool/karakter Karakterin küçük harfli alfabetik bir harf olup olmadığını sınar
Isnoktalama Statik yöntem bool/karakter Karakterin bir noktalama işareti olup olmadığını sınar
IsUpper Statik yöntem bool/karakter Karakterin büyük harfli alfabetik bir harf olup olmadığını sınar
IsWhiteSpace Statik yöntem bool/karakter Karakterin boşluk karakteri olup olmadığını sınar.
ToLower Statik yöntem karakter/dize Karakteri küçük harfe dönüştürür
ToUpper Statik yöntem karakter/dize Karakteri büyük harfe dönüştürür

Windows PowerShell: char System. char öğesine eşlenir.

4.2.3 tamsayı

İki işaretli tamsayı türü vardır, her ikisi de negatif değerler için iki adet tamamlama temsili kullanır:

  • 32 bitleri kullanan, bu tür int bir-2147483648 ile + 2147483647 (dahil) arasında bir Aralık verir.
  • 64 bitleri kullanan, bu tür bir-9223372036854775808 ile + 9223372036854775807 (dahil) arasında bir Aralık veren türüdür long .

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

Üye Üye türü Tür Amaç
Değerini Static özelliği (salt okunurdur) int İnt türünde olası en büyük değer
MinValue Static özelliği (salt okunurdur) int İnt türünde olası en küçük değer

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

Üye Üye türü Tür Amaç
Değerini Static özelliği (salt okunurdur) long Long türünde olası en büyük değer
MinValue Static özelliği (salt okunurdur) long Long türünde olabilecek en küçük değer

İşaretsiz bir tamsayı türü vardır:

  • 8 bit kullanan, buna dahil olmak üzere 0 ile 255 arasında bir Aralık sağlayan tür byte .

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

Üye Üye türü Tür Amaç
Değerini Static özelliği (salt okunurdur) byte Bayt türünde olası en büyük değer
MinValue Static özelliği (salt okunurdur) byte Byte türünde olası en küçük değer

PowerShell, byte ,, ve long sırasıyla, System.Int32 , ve System.Int64 ile eşleyin System.Byte int .

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 BITLIK IEEE tek duyarlıklı gösterimi kullanır.
  • Tür double , 64 BITLIK IEEE çift duyarlıklı gösterimini kullanır.

Üçüncü bir tür adı single , bu belirtim boyunca Type float ; float için bir eş anlamlı kullanılır.

Türlerin float double boyut ve gösterimi ve bu belirtim tarafından tanımlanmakla birlikte, bir uygulama ara sonuçlar için genişletilmiş duyarlık kullanabilir.

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

Üye Üye türü Tür Amaç
Değerini Static özelliği (salt okunurdur) float Float türünde olası en büyük değer
MinValue Static özelliği (salt okunurdur) float Float türünün en küçük olası değeri
NaN Static özelliği (salt okunurdur) float Sabit değer-a-sayı değil
NegativeInfinity değerini alan Static özelliği (salt okunurdur) float Sabit değer negatif sonsuzluk
PositiveInfinity Static özelliği (salt okunurdur) float Sabit değer pozitif sonsuzluk

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

Üye Üye türü Tür Amaç
Değerini Static özelliği (salt okunurdur) double Double türünde olası en büyük değer
MinValue Static özelliği (salt okunurdur) double Double türünde olası en küçük değer
NaN Static özelliği (salt okunurdur) double Sabit değer-a-sayı değil
NegativeInfinity değerini alan Static özelliği (salt okunurdur) double Sabit değer negatif sonsuzluk
PositiveInfinity Static özelliği (salt okunurdur) double Sabit değer pozitif sonsuzluk

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

4.2.4.2 ondalık

Tür Decimal, 128 bitlik bir temsili kullanır. En azından, 0 <= s <= en az 28 ve değer aralığı-79228162514264337593543950335 için olan bir ölçeği desteklemesi gerekir 79228162514264337593543950335. Gerçek ondalık temsili uygulama tanımlı ' dır.

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

Üye Üye türü Tür Amaç
Değerini Static özelliği (salt okunurdur) decimal Decimal türünde olası en büyük değer
MinValue Static özelliği (salt okunurdur) decimal Decimal türünde olası en küçük değer

Not

Decimal gerçek sayıların, ondalık noktanın sağ tarafındaki basamak sayısını temsil eden Scale adlı bir özelliği vardır. Örneğin 2,340 değeri, sondaki sıfırların önemli olduğu 3 ölçeğinde bir ölçeğe sahiptir. İki ondalık gerçek sayı eklendiğinde veya çıkarıldığında, sonucun ölçeği iki ölçekten büyük olur. Örneğin, 1,0 + 2,000, 5,0-2,00 ise 3,000. İki ondalık gerçek sayı çarpıldığı zaman, sonucun ölçeği iki ölçeklendirmenin toplamıdır. Örneğin, 1,0 * 2,000, 2,0000. İki ondalık gerçek sayı bölündüğünde, sonucun ölçeği ikincinin ölçeklendirilmesi için ölçeğin ölçeklendirilmesi olur. Örneğin, 4.00000/2.000, 2,00 ' dir. Ancak, bir ölçek doğru sonucu korumak için gerekenden daha az olamaz. Örneğin, 3.000/2.000, 3.00/2.000, 3.0/2.000 ve 3/2 hepsi 1,5 ' dir.

PowerShell 'de, decimal ile System.Decimal eşlenir. Decimal öğesinin temsili aşağıdaki gibidir:

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

anahtar türünü 4.2.5

Bu tür, bir komutta 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 testlerini $true; Aksi takdirde, test eder $false .

PowerShell 'de, switch ile System.Management.Automation.SwitchParameter eşlenir.

4.2.6 sabit listesi türleri

Sabit listesi türü, söz konusu Numaralandırma türündeki bir nesneye atanabilen tüm olası değerleri temsil eden adlandırılmış sabitler kümesini tanımlayan bir nesnedir. Bazı durumlarda, değer kümesi, bir seferde yalnızca bir değer temsil edilebilir. Diğer durumlarda, değer kümesi iki farklı üsdür ve-bVEYA işleci (§ 7.8.5) kullanılarak birden çok değer aynı nesnede kodlanamaz.

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, erişilebilir üyelere sahiptir:

Üye Üye türü Amaç
Devam et Sabit Listesi sabiti PowerShell çalışma zamanı işleme devam eder ve kullanıcıya bir eylem gerçekleştiğini bildirir.
Olmadığını Sabit Listesi sabiti PowerShell çalışma zamanı işlemeyi durdurur ve kullanıcıya nasıl devam etmesi gerektiğini sorar.
SilentlyContinue Sabit Listesi sabiti PowerShell çalışma zamanı, kullanıcıya bir eylem gerçekleştiğini bildirmeden işleme devam eder.
Durdur Sabit Listesi sabiti Bir eylem gerçekleştiğinde PowerShell çalışma zamanı işlemeyi durdurur.

PowerShell 'de bu tür olur System.Management.Automation.ActionPreference .

4.2.6.2 Confirm-Impact türü

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

Üye Üye türü Amaç
Yüksek Sabit Listesi sabiti Gerçekleştirilen eylemin, bir sabit diski yeniden biçimlendirme gibi verileri kaybetme konusunda yüksek bir riski vardır.
Düşük Sabit Listesi sabiti Gerçekleştirilen eylemin verileri kaybetme riski düşüktür.
Orta Sabit Listesi sabiti Gerçekleştirilen eylemin verilerin kaybedilmesi için orta riskli bir riski vardır.
Hiçbiri Sabit Listesi sabiti Herhangi bir eylemi onaylamayın (tüm onay isteklerini gizleyin).

PowerShell 'de bu tür olur System.Management.Automation.ConfirmImpact .

4.2.6.3 File-Attributes türü

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

Üye Üye türü Amaç
Arşiv Sabit Listesi sabiti Dosyanın arşiv durumu. Uygulamalar, dosyaları yedekleme veya kaldırma için işaretlemek üzere bu özniteliği kullanır.
Sıkıştırılmış Sabit Listesi sabiti Dosya sıkıştırılır.
Cihaz Daha sonraki kullanımlar için ayrılmıştır.
Dizin Sabit Listesi sabiti Dosya bir dizindir.
Şifreli Sabit Listesi sabiti Dosya veya dizin şifrelenir. Bir dosya için, dosyadaki tüm verilerin şifrelenme anlamına gelir. Bir dizin için bu, şifrelemenin yeni oluşturulan dosyalar ve dizinler için varsayılan değer olduğu anlamına gelir.
Gizli Sabit Listesi sabiti Dosya gizlidir ve bu nedenle sıradan bir dizin listesine eklenmez.
Normal Sabit Listesi sabiti Dosya normaldir ve başka hiçbir özniteliğe ayarlı değildir. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir.
Notcontentındexed Sabit Listesi sabiti Dosya, işletim sisteminin içerik dizin oluşturma hizmeti tarafından dizinlenmeyecek.
Çevrimdışı Sabit Listesi sabiti Dosya çevrimdışı. Dosyanın verileri hemen kullanılamaz.
ReadOnly Sabit Listesi sabiti Dosya salt okunurdur.
ReparsePoint Sabit Listesi sabiti Dosya, bir dosya veya dizin ile ilişkili kullanıcı tanımlı veri bloğu olan bir yeniden ayrıştırma noktası içerir.
SparseFile Sabit Listesi sabiti Dosya seyrek bir dosyadır. Seyrek dosyalar genellikle verileri genellikle sıfır olan büyük dosyalardır.
Sistem Sabit Listesi sabiti 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 Sabit Listesi sabiti Dosya geçicidir. Dosya sistemleri, verileri yığın depolamaya geri almak yerine daha hızlı erişim için bellekteki tüm verileri tutmaya çalışır. Geçici bir dosya artık gerekli olmadığı anda uygulama tarafından silinmelidir.

PowerShell 'de bu tür, öznitelik FlagsAttribute ile System. ıO. FileAttributes ' dir.

4.2.6.4 normal Ifade-seçenek türü

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

Üye Üye türü Amaç
IgnoreCase Sabit Listesi sabiti Eşleştirmesinin büyük/küçük harfe duyarlı olduğunu belirtir.
Hiçbiri Sabit Listesi sabiti Hiçbir seçenek ayarlanın olmadığını belirtir.

Uygulama, diğer değerleri sağlayabilir.

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

4,3 başvuru türleri

4.3.1 dizeleri

Bir dize değeri tür dizesine sahiptir ve her biri, UTF-16 kodlu 16 bit Unicode kod noktası içeren, Char türünde sıfır veya daha fazla karakterden oluşan sabit bir dizidir.

Tür dizesinde aşağıdaki erişilebilir Üyeler bulunur:

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

PowerShell 'de, string ile System.String eşlenir.

4.3.2 dizileri

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

Üye Üye türü Tür Amaç
Uzunluk Örnek özelliği (salt okunurdur) int Dizideki öğelerin sayısı
Derece Örnek özelliği (salt okunurdur) int Dizideki boyut sayısı
Kopyala Static yöntemi void/See amaç sütunu

Öğe aralığını bir diziden diğerine kopyalar. Kaynak dizinin Kaynak dizisi olduğu dört sürüm vardır, hedef dizidir, sayı kopyalanacak öğelerin sayısıdır ve sourceIndex ve destinationIndex , kendi dizilerindeki başlangıç konumlarıdır:

Copy (kaynak, hedef, int sayısı)
Copy (kaynak, hedef, uzun sayı)
Copy (kaynak, sourceIndex, hedef, destinationIndex, int sayısı)
Copy (kaynak, sourceIndex, hedef, destinationIndex, Long Count)

GetLength Örnek yöntemi (salt okunurdur) int/None

Belirli boyuttaki öğe sayısı

GetLength (int Boyut)

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

PowerShell 'de, Array ile System.Array eşlenir.

4.3.3 hashtables

Tür Hashtable 'da aşağıdaki erişilebilir Üyeler vardır:

Üye Üye türü Tür Amaç
Count Örnek özelliği int Hashtable 'daki anahtar/değer çiftleri sayısını alır
Anahtarlar Örnek özelliği Uygulama tanımlı Tüm anahtarların bir koleksiyonunu alır
Değerler Örnek özelliği Uygulama tanımlı Tüm değerlerin bir koleksiyonunu alır
Kaldır Örnek yöntemi void/None Belirtilen anahtarı/değeri kaldırır

Diyez tabloları hakkında daha fazla bilgi için bkz. § 10.

PowerShell 'de, Hashtable ile System.Collections.Hashtable eşlenir. Hashtable öğeler türünde DictionaryEntry bir nesne içinde depolanır ve anahtarlar ve değerler tarafından döndürülen koleksiyonların türü ICollection vardır.

4.3.4 xml türü

Type XML, W3C Belge Nesne Modeli (DOM) düzey 1 çekirdeğini ve çekirdek DOM düzeyi 2 ' ye uygular. DOM bir XML belgesinin bellek içi (önbellek) ağaç gösterimidir ve bu belgenin gezinmesini ve düzenlenmesine izin vermez. Bu tür [] alt indis işlecini destekler (§ 7.1.4.4).

PowerShell 'de, xml ile System.Xml.XmlDocument eşlenir.

4.3.5 Regex türü

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

PowerShell 'de, regex ile System.Text.RegularExpressions.Regex eşlenir.

4.3.6 başvuru türü

Normalde, bağımsız değişkenler değere göre komutlara geçirilir. Değer türünde bir bağımsız değişken olması durumunda değer kopyası geçirilir. Bir bağımsız değişken olması durumunda başvurunun bir kopyası geçirilir.

Tür başvurusu, bağımsız değişkenlerin komuta başvuruya göre geçirilmesine izin vermek için makineler sağlar, böylece komutlar bağımsız değişkenin değerini değiştirebilir. Tür başvurusu aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye türü Tür Amaç
Değer Örnek ö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ıyı 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ıtlı olan 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şkeni hem de karşılık gelen parametresi bildirilmelidir ref .

PowerShell 'de, ref ile System.Management.Automation.PSReference eşlenir.

ScriptBlock türünü 4.3.7

Tür scriptblock , tek bir birim olarak kullanılabilen, ö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ç
Öznitelikler Örnek özelliği (salt okunurdur) Öznitelik koleksiyonu Betik bloğunun özniteliklerini alır.
Dosya Örnek özelliği (salt okunurdur) string Betik bloğunun tanımlandığı dosya adını alır.
Modül Örnek özelliği (salt okunurdur) uygulama tanımlı ([§ 4.5.12] [§ 4.5.12]) Betik bloğunun tanımlandığı modül hakkında bilgi alır.
Getnewkapanış Örnek yöntemi ScriptBlock
/None
Bir modüle bağlanan bir betik bloğu alır. Çağıranın bağlamındaki tüm yerel değişkenler modüle kopyalanır.
Çağır Örnek yöntemi Nesne/nesne koleksiyonu [] Komut dosyası bloğunu belirtilen bağımsız değişkenlerle çağırır ve sonuçları döndürür.
InvokeReturnAsIs Örnek yöntemi nesne/nesne [] Komut dosyası bloğunu belirtilen bağımsız değişkenlerle çağırır ve oluşturulan tüm nesneleri döndürür.
Oluştur Statik yöntem ScriptBlock
/String
Belirtilen betiği içeren yeni bir ScriptBlock nesnesi oluşturur.

PowerShell 'de, scriptblock ile System.Management.Automation.ScriptBlock eşlenir. Invoke bir koleksiyonunu PsObject döndürür.

Matematik türünü 4.3.8

Tür math , matematiksel hesaplamalar için yararlı bazı sabitler ve yöntemlere erişim sağlar. Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye türü Tür Amaç
E Static özelliği (salt okunurdur) double Doğal Logaritmik taban
PI Static özelliği (salt okunurdur) double Dairenin çapının çapına oranı
Abs 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ı)
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ı belirtilen sayı olan açı
Atan2 Statik yöntem Çift/Çift y, Çift x Tanjantı x ve y belirtilen iki sayının bölümü olan açı
Ceiling Statik yöntem

ondalık/ondalık

Çift/Çift

belirtilen sayıdan büyük veya eşit en küçük tamsayı
Cos 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 üse yükseltilmiş
Floor Statik yöntem

ondalık/ondalık

Çift/Çift

En büyük tamsayı belirtilen sayıdan küçük veya eşit
Günlük Statik yöntem

Çift/Çift sayı

Çift/Çift sayı, Çift taban

Taban e veya taban tabanı kullanarak sayı logaritması
Log10 Statik yöntem Çift/Çift Belirtilen sayının 10 tabanında logaritması
En yüksek değer Statik yöntem sayısal/sayısal Belirtilen iki sayıdan daha büyük (dönüş türü, geçirilen bağımsız değişkenlerin türüyle aynı)
Min Statik yöntem sayısal/sayısal, sayısal Belirtilen iki sayıdan daha küçük (dönüş türü, geçirilen bağımsız değişkenlerin türüyle aynı)
POW Statik yöntem Çift/Çift x, Çift y Belirtilen üsle belirtilen x olarak belirtilen sayı
Sin Statik yöntem Çift/Çift Belirtilen açının sinüsü
Sinh Statik yöntem Çift/Çift Belirtilen açının hiperbolik sinüsü
Sqrt Statik yöntem Çift/Çift Belirtilen sayının kare kökü
Tan Statik yöntem Çift/Çift Belirtilen açının tanjantı
Tanh Statik yöntem Çift/Çift Belirtilen açının hiperbolik tanjantı

PowerShell 'de, Math ile System.Math eşlenir.

4.3.9 sıralı türü

Tür ordered yalnızca dönüştürmeler için kullanılan bir sözde 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ür.

4.4 Genel türler

Bir dizi programlama dili ve ortam, özelleştirilmiş türler sağlar. Bu türlerin çoğu kapsayıcı türleri olarak adlandırılır, bunların örnekleri başka bir türdeki nesneleri içerebilir. Bir değer yığınını temsil eden Stack adlı bir türü düşünün; bu değer yığını üzerine yazarak çıkarabilirsiniz. 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ştirmesini desteklemezse, Stack türünün birden çok farklı varyantı, yalnızca farklı tür öğeleriyle aynı görevi gerçekleştirse bile uygulanmalıdır.

Tür özelleştirmesi, genel bir türün, kullanılırken türlerin bazı alt kümelerini işlemeye kısıtlanmış olacak şekilde uygulanmasına olanak sağlar. Örneğin,

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

PowerShell herhangi bir yerleşik genel tür tanımlamasa da, konak ortamı tarafından sağlanıyorsa bu tür türleri kullanabilir. Bkz. sözdizimi :7.1.10.

Yukarıda önerilen tür için tam Stack[string] ad şu şekildedir System.Collections.Generic.Stack[string]: . Yukarıda önerilen tür için tam Dictionary[int,string] ad şu şekildedir System.Collections.Generic.Dictionary[int,string]: .

4.5 Anonim türler

Bazı durumlarda, Bir PowerShell uygulaması bazı tür nesneleri oluşturur ve bu nesnelerin üyeleri betik tarafından erişilebilir. Ancak, erişilebilir üyeler kullanılacak kadar yeterli şekilde belirtildiklerine göre bu türlerin gerçek adı belirtilmez. Diğer bir ifadeyle betikler bu türdeki nesneleri kaydedebilir ve bu türlerin adlarını bilmeden üyelerine erişebilir. Aşağıdaki alt bölümlerde bu türler belirtildi.

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

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

Üye Üye Tür Tür Amaç
Sürücüler Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.2) Sürücü açıklaması nesneleri koleksiyonu
Name Örnek özelliği (salt okunur) string Sağlayıcının adı

PowerShell'de bu tür: System.Management.Automation.ProviderInfo.

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

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

Üye Üye Tür Tür Amaç
CurrentLocation Örnek özelliği (okuma-yazma) string Sürücünün geçerli çalışma konumu (yaklaşık 3.1.4)
Description Örnek özelliği (okuma-yazma) string Sürücünün açıklaması
Name Örnek özelliği (salt okunur) string Sürücünün adı
Root Örnek özelliği (salt okunur) string Sürücünün adı

PowerShell'de bu tür: 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 sahip:

Üye Üye Tür Tür Amaç
Öznitelikler Örnek özelliği (salt okunur) Uygulama tanımlı Öznitelik koleksiyonu
Description Örnek özelliği (okuma-yazma) string 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ı (yaklaşık 4.5.12) Bu değişkenin dışarı aktarıldı olduğu modül
Modulename Örnek özelliği (salt okunur) string Bu değişkenin tanımlandığı modül
Name Örnek özelliği (salt okunur) string PowerShell dilinde veya ve Set-Variable cmdlet'leri aracılığıyla oluşturulduğunda değişkenine New-Variable atanan ad.
Seçenekler Örnek özelliği (okuma-yazma) string ve cmdlet'leri aracılığıyla değişkenine New-Variable Set-Variable atanan seçenekler.
Değer Örnek özelliği (okuma-yazma) object PowerShell dilinde veya ve Set-Variable cmdlet'leri aracılığıyla atandığı zaman New-Variable değişkenine atanan değer.

PowerShell'de bu tür: System.Management.Automation.PSVariable.

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

4.5.4 Diğer ad açıklama türü

Bu tür, bir diğer adın durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahip:

Üye Üye Tür Tür Amaç
Commandtype Örnek özelliği (salt okunur) Uygulama tanımlı "Diğer Ad" ile eşit karşılaştırması gerekir.
Tanım Örnek özelliği (salt okunur) string Diğer adın New-Alias veya Set-Alias cmdlet'leri aracılığıyla atandığı komut veya diğer ad.
Description Örnek özelliği (okuma-yazma) string veya cmdlet'leri aracılığıyla diğer ada New-Alias Set-Alias atanan açıklama.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.12) Bu diğer adın dışarı aktarıldı olduğu modül
Modulename Örnek özelliği (salt okunur) string Bu diğer adın tanımlandığı modül
Name Örnek özelliği (salt okunur) string veya cmdlet'leri aracılığıyla oluşturulduğunda diğer ada New-Alias Set-Alias atanan ad.
Seçenekler Örnek özelliği (okuma-yazma) string Diğer ada, New-Alias New-Alias Set-Alias veya cmdlet'leri aracılığıyla atanan seçenekler.
OutputType Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Diğer adın başvurduğu komutun çıkış değeri türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Komutun parametreleri.
ParameterSets Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon komutuyla ilişkili parametre kümeleri hakkında bilgi.
ReferencedCommand Örnek özelliği (salt okunur) Uygulama tanımlı Bu diğer ad tarafından hemen başvurulan komut hakkında bilgi.
ResolvedCommand Örnek özelliği (salt okunur) Uygulama tanımlı Diğer adın sonunda çözümlen komut hakkında bilgiler.

PowerShell'de bu tür: 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 sahip:

Üye Üye Tür Tür Amaç
Sürücü Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.2) Sürücü açıklaması nesnesi
Yol Örnek özelliği (salt okunur) string Çalışma konumu
Sağlayıcı Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.1) Sağlayıcı
ProviderPath Örnek özelliği (salt okunur) string Sağlayıcının geçerli yolu

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

PowerShell'de, geçerli çalışma konumu türünde bir nesneyle temsil eder System.Management.Automation.PathInfo. Çalışma konumları yığını, nesne koleksiyonu olan System.Management.Automation.PathInfoStacktüründe bir nesneyle temsil PathInfo eder.

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 sahip:

Üye Üye Tür Tür Amaç
Name Örnek özelliği (okuma-yazma) string Ortam değişkeninin adı
Değer Örnek özelliği (okuma-yazma) string Ortam değişkeninin değeri

PowerShell'de bu tür: 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 , Anahtar'a AliasProperty eşit olan bir addır.

4.5.7 Uygulama açıklaması türü

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

Üye Üye Tür Tür Amaç
Commandtype Örnek özelliği (salt okunur) Uygulama tanımlı "Uygulama" ile eşit karşılaştırması gerekir.
Tanım Örnek özelliği (salt okunur) string Uygulamanın açıklaması.
Dahili numara Örnek özelliği (okuma-yazma) string Uygulama dosyasının uzantısı.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.12) Bu komutu tanımlayan modül.
Modulename Örnek özelliği (salt okunur) string Komutu tanımlayan modülün adı.
Name Örnek özelliği (salt okunur) string Komutun adı.
OutputType Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon komutu tarafından çıkış değeri türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Komutun parametreleri.
ParameterSets Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon komutuyla ilişkili parametre kümeleri hakkında bilgi.
Yol Örnek özelliği (salt okunur) string Uygulama dosyasının yolunu alır.

PowerShell'de bu tür: System.Management.Automation.ApplicationInfo.

4.5.8 Cmdlet açıklama türü

Bu tür bir cmdlet'in durumunu kapsüller. Aşağıdaki erişilebilir üyelere sahip:

Üye Üye Tür Tür Amaç
Commandtype Örnek özelliği (salt okunur) Uygulama tanımlı "Cmdlet" ile eşit karşılaştırması gerekir.
DefaultParameterSet Örnek özelliği (salt okunur) Uygulama tanımlı PowerShell, sağlanan bağımsız değişkenlere göre hangi parametre kümesi kullanılacakı belirleyeyene kadar kullanılan varsayılan parametre kümesi.
Tanım Örnek özelliği (salt okunur) string Cmdlet'in açıklaması.
Helpfile Örnek özelliği (okuma-yazma) string cmdlet'i için Yardım dosyasının yolu.
ImplementingType Örnek özelliği (okuma-yazma) Uygulama tanımlı cmdlet'ini uygulayan tür.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.12) Bu cmdlet'i tanımlayan modül.
Modulename Örnek özelliği (salt okunur) string cmdlet'ini tanımlayan modülün adı.
Name Örnek özelliği (salt okunur) string Cmdlet'in adı.
Isim Örnek özelliği (salt okunur) string Cmdlet'in isim adı.
OutputType Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon cmdlet'i tarafından çıkış değeri türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon cmdlet'inin parametreleri.
ParameterSets Ö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) string Cmdlet'in fiil adı.
PSSnapIn Örnek özelliği (salt okunur) Uygulama tanımlı Windows PowerShell: Cmdlet'i Windows powershell ek bileşeni hakkında bilgiler.

PowerShell'de bu tür: System.Management.Automation.CmdletInfo.

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

Bu tür bir dış betiğin durumunu kapsüller (PowerShell tarafından doğrudan yürütülebilir olan ancak yerleşik olarak yer alan bir betik). Aşağıdaki erişilebilir üyelere sahip:

Üye Üye Tür Tür Amaç
Commandtype Örnek özelliği (salt okunur) Uygulama tanımlı "ExternalScript" ile eşit karşılaştırması gerekir.
Tanım Örnek özelliği (salt okunur) string Betiğin tanımı.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.12) Bu betiği tanımlayan modül.
Modulename Örnek özelliği (salt okunur) string Betiği tanımlayan modülün adı.
Name Örnek özelliği (salt okunur) string 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.
OutputType Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Betiğin çıktısı olan değer türlerini belirtir.
Parametreler Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Betiğin parametreleri.
ParameterSets Örnek özelliği (salt okunur) Uygulama tanımlı koleksiyon Betikle ilişkili parametre kümeleri hakkında bilgi.
Yol Örnek özelliği (salt okunur) string Betik dosyasının yolu.
ScriptBlock Örnek özelliği (salt okunur) scriptblock Dış betik.
ScriptContents Örnek özelliği (salt okunur) string Betiğin özgün içeriği.

PowerShell'de bu tür: System.Management.Automation.ExternalScriptInfo.

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

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

Üye Üye Tür Tür Amaç
CmdletBinding Örnek özelliği (salt okunur) bool İşlevin, derlenmiş cmdlet'ler tarafından kullanılan aynı parametre bağlaması kullanıp kullanmadiğini gösterir (bkz. .12.3.5).
Commandtype Örnek özelliği (salt okunur) Uygulama tanımlı Bu nesnenin hangilerini temsil ettiğini görmek için eşitlik için "İşlev" veya "Filtre" ile karşılaştırabilirsiniz.
DefaultParameterSet Örnek özelliği (salt okunur) string Bağımsız değişkenlerden belirlenenine kadar kullanmak üzere parametre kümesi belirtir ( bkz.12.3.5).
Tanım Örnek özelliği (salt okunur) string ScriptBlock'un dize sürümü
Description Örnek özelliği (okuma-yazma) string İşlevin açıklaması.
Modül Örnek özelliği (salt okunur) Uygulama tanımlı (yaklaşık 4.5.12) Bu işlevin dışarı aktarıldı olduğu modül
Modulename Örnek özelliği (salt okunurdur) string Bu işlevin tanımlandığı modül
Name Örnek özelliği (salt okunurdur) string İşlevin adı
Seçenekler Örnek özelliği (okuma-yazma) Uygulama tanımlı İşlevin kapsam seçenekleri (§ 3.5.4).
#B2 Örnek özelliği (salt okunurdur) Uygulama tanımlı koleksiyon Değer çıktısının türlerini sırasıyla belirtir (bkz. § 12.3.6).
Parametreler Örnek özelliği (salt okunurdur) Uygulama tanımlı koleksiyon Parametre adlarını sırayla belirtir. İşlev bir cmdlet gibi davranır (yukarıdaki CmdletBinding 'e bakın) koleksiyonun sonuna genel parametreler dahil edilir.
ParameterSets Örnek özelliği (salt okunurdur) 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 parametrenin zorunlu olup olmadığını konuma veya anahtar parametresine göre gösterir. İşlev bir cmdlet gibi davranır (yukarıdaki CmdletBinding 'e bakın) koleksiyonun sonuna genel parametreler dahil edilir.
ScriptBlock Örnek özelliği (salt okunurdur) ScriptBlock (§ 4.3.6) İşlevin gövdesi

PowerShell 'de bu tür olur System.Management.Automation.FunctionInfo .

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

4.5.11 filtresi açıklama türü

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

PowerShell 'de bu tür olur System.Management.Automation.FilterInfo . Aynı özellik System.Management.Automation.FunctionInfo kümesine (§ 4.5.11) 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ç
Description Örnek özelliği (okuma-yazma) string Modülün açıklaması (bildirime göre ayarlanır)
ModuleType Örnek özelliği (salt okunurdur) Uygulama tanımlı Modülün türü (bildirim, betik veya Ikili)
Name Örnek özelliği (salt okunurdur) string Modülün adı
Yol Örnek özelliği (salt okunurdur) string Modülün yolu

PowerShell 'de bu tür olur System.Management.Automation.PSModuleInfo . Türü ModuleType System.Management.Automation.ModuleType .

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 tür olur System.Management.Automation.PSCustomObject . Cmdlet 'leri Import-Module ve New-Object Bu türden bir nesne oluşturabilir.

4.5.14 komutu açıklama türü

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

Üye Üye türü Tür Amaç
ParameterSetName Örnek özelliği (salt okunurdur) string Geçerli parametre kümesinin adı (bkz. ParameterSetName)
ShouldContinue Örnek yöntemi

Değişkenlerle

/bool

Kullanıcıdan bir işlemin onayını ister.
ShouldProcess Örnek yöntemi

Değişkenlerle

/bool

Bir işlem gerçekleştirilmeden önce kullanıcıdan onay ister.

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

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

Otomatik değişken $Error , son hataları temsil eden hata kayıtlarının bir koleksiyonunu içerir (§ 3,12). Bu koleksiyonun türü belirtilmemiş olsa da, bireysel hata kayıtlarına erişim sağlamak için alt simge kullanımını destekler.

PowerShell 'de, koleksiyon türü System.Collections.ArrayList . Koleksiyondaki System.Management.Automation.ErrorRecord tek bir hata kaydının türü. Bu tür aşağıdaki ortak ö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 - Hatanın meydana geldiği zaman çağrılan komutla ilgili bilgileri alır.
  • PipelineIterationInfo - Bu hata kaydı oluşturulduğunda işlem hattının durumunu alır
  • TargetObject - Hata meydana geldiğinde işlenen nesneyi alır.

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

Bir dizi değişken, koleksiyonlar için numaralayıcılardır (yaklaşık 4). Otomatik değişken, $foreach herhangi bir deyim için oluşturulan numaralayıcıdır foreach . Otomatik değişken, $input işlem hattından bir işleve teslim edilen koleksiyonun numaralayıcıdır. Otomatik değişken, $switch herhangi bir deyim için oluşturulan numaralayıcıdır switch .

Numaralayıcının türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahip:

Üye Üye Tür Tür Amaç
Geçerli Örnek özelliği (salt okunur) object Koleksiyonda geçerli öğeyi alır. Numaralayıcı şu anda koleksiyonun bir öğesinde konumlanmamışsa, davranış uygulama tanımlıdır.
Movenext Örnek yöntemi Hiçbiri/bool Numaralayıcıyı koleksiyonun sonraki öğesine ilerleter. Numara $true sonraki öğeye başarıyla ilerlemişse, aşağıdakini döndürür; $false numaralayıcının koleksiyonun sonunu geçirip geçirip geçire $false olduğunu doğrular.

PowerShell'de bu üyeler, aşağıda tanımlanan System.IEnumeratortürler tarafından uygulanan arabiriminde tanımlanır. Numaralayıcı şu anda koleksiyonun bir öğesinde konumlanmazsa, türünde bir özel durum InvalidOperationException ortaya çıkar. için $foreachbu tür: System.Array+SZArrayEnumerator. için $inputbu tür: System.Collections.ArrayList+ArrayListEnumeratorSimple. için $switchbu tür: System.Array+SZArrayEnumerator.

4.5.17 Dizin açıklaması türü

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

Üye Üye Tür Tür Amaç
Öznitelikler Örnek özelliği (okuma-yazma) Uygulama tanımlı (yaklaşık 4.2.6.3) Dizin nesnesinin özniteliklerinden birini veya daha fazlasını alır veya ayarlar.
CreationTime Örnek özelliği (okuma-yazma) Uygulama tanımlı (yaklaşık 4.5.19) Dizin nesnesinin oluşturma zamanlarını alır ve ayarlar.
Dahili numara Örnek özelliği (salt okunur) string Dizin adının uzantı bölümünü alır.
FullName Örnek özelliği (salt okunur) string Dizinin tam yolunu alır.
LastWriteTime Örnek özelliği (okuma-yazma) Uygulama tanımlı (yaklaşık 4.5.19) Dizinin en son yazıldığı zamanı alır ve ayarlar.
Name Örnek özelliği (salt okunur) string Dizinin adını alır.

PowerShell'de bu tür: System.IO.DirectoryInfo. Attributes özelliğinin türü olurSystem.IO.FileAttributes.

4.5.18 Dosya açıklaması türü

cmdlet'i 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 sahip:

Üye Üye Tür Tür Amaç
Öznitelikler Örnek özelliği (okuma-yazma) Uygulama tanımlı (yaklaşık 4.2.6.3) Dosya nesnesinin özniteliklerinden birini veya daha fazlasını alır veya ayarlar.
Basename Örnek özelliği (salt okunur) string Uzantı hariç dosyanın adını alır.
CreationTime Örnek özelliği (okuma-yazma) Uygulama tanımlı (yaklaşık 4.5.19) Dosya nesnesinin oluşturma zamanlarını alır ve ayarlar.
Dahili numara Örnek özelliği (salt okunur) string Dosya adının uzantı bölümünü alır.
FullName Örnek özelliği (salt okunur) string Dosyanın tam yolunu alır.
LastWriteTime Örnek özelliği (okuma-yazma) Uygulama tanımlı (yaklaşık 4.5.19) Dosyanın en son yazıldığı zamanı alır ve ayarlar.
Uzunluk Örnek özelliği (salt okunur) long Dosyanın boyutunu bayt cinsinden alır.
Name Örnek özelliği (salt okunur) string Dosyanın adını alır.
VersionInfo Örnek özelliği (salt okunur) Uygulama tanımlı Windows PowerShell: Bu ScriptProperty, dosya için bir System.Diagnostics.FileVersionInfo döndürür.

PowerShell'de bu tür: System.IO.FileInfo.

4.5.19 Date-Time türü

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

Ü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.
Second Ö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 cmdlet'i tarafından oluşturulabilir.

PowerShell'de bu tür: System.DateTime.

4.5.20 Group-Info türü

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

Üye Üye Tür Tür Amaç
Count Ö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.
Name Örnek özelliği (salt okunur) string Grubun adını alır.
Değerler Ö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 tür: Microsoft.PowerShell.Commands.GroupInfo.

4.5.21 Genel Ölçü Bilgisi açıklama türü

Genel ölçü bilgisi açıklama nesnesinin türü uygulama tanımlıdır; aşağıdaki erişilebilir üyelere sahip:

Üye Üye Tür Tür Amaç
Ortalama Örnek özelliği (salt okunur) double Ölçülen özelliklerin değerlerinin ortalamasını alır.
Count Örnek özelliği (salt okunur) int Belirtilen özelliklere sahip nesne sayısını alır.
Maksimum Örnek özelliği (salt okunur) double Belirtilen özelliklerin en yüksek değerini alır.
Minimum Örnek özelliği (salt okunur) double Belirtilen özelliklerin minimum değerini alır.
Özellik Örnek özelliği (salt okunur) string Ölçülebilir özelliğini alır.
Sum Örnek özelliği (salt okunur) double Belirtilen özelliklerin değerlerinin toplamını alır.

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

PowerShell'de bu tür: Microsoft.PowerShell.Commands.GenericMeasureInfo.

4.5.22 Metin-Ölçü Bilgisi açıklama türü

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

Üye Üye türü Tür Amaç
Karakterler Örnek özelliği (salt okunurdur) int Hedef nesnedeki karakter sayısını alır.
Satırlar Örnek özelliği (salt okunurdur) int Hedef nesnedeki satır sayısını alır.
Özellik Örnek özelliği (salt okunurdur) string Ölçülecek özelliği alır.
Ünde Örnek özelliği (salt okunurdur) int Hedef nesnedeki sözcüklerin sayısını alır.

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

PowerShell 'de bu tür olur 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. Bir kimlik bilgisi nesnesinin türü uygulama tanımlı; Aşağıdaki erişilebilir üyelere sahiptir:

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

Bu türden bir nesne, cmdlet Get-Credentialile oluşturulabilir.

PowerShell 'de bu tür olur System.Management.Automation.PSCredential .

4.5.24 yöntemi gösterge türü

Yöntem göstergesinin türü uygulama tanımlı ' dır; Aşağıdaki erişilebilir üyelere sahiptir:

Üye Üye türü Tür Amaç
Çağır Örnek yöntemi nesne/değişken numarası ve türü Değişken sayıda bağımsız değişken alır ve bağımsız değişkenleri geçirerek üst Yöntem göstergesinin başvurduğu yöntemi dolaylı olarak çağırır.

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

PowerShell 'de, bu tür System. Management. Automation. PSMethod ' dır.

4.5.25 üyesi 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 okunurdur) string Üyenin tanımını alır.
MemberType Örnek özelliği (salt okunurdur) Uygulama tanımlı Üyenin PowerShell türünü alır.
Name Örnek özelliği (salt okunurdur) string Üyenin adını alır.
TypeName Örnek özelliği (salt okunurdur) string Üyenin tür adını alır.

PowerShell 'de bu tür olur Microsoft.PowerShell.Commands.MemberDefinition .

4,6 tür uzantısı ve uyarlama

Bir PowerShell uygulamasına, her birinin kendi temel üye kümesini içeren bir çekirdek türleri ailesi (Bu bölümde belgelenen) bulunur. Bu Üyeler Yöntem veya özellik olabilir ve örnek veya statik Üyeler olabilir. Örneğin, tür dizesinin temel üyeleri (§ 4.3.1), örnek özellik uzunluðu ve örnek yöntemleri ToLower ve ToUpper ' dir.

Bir nesne oluşturulduğunda, bu nesnenin türünün tüm örnek özelliklerini içerir ve bu türün örnek yöntemleri bu nesnede çağrılabilir. Bir nesne, çalışma zamanında örnek üyelerini ekleme yoluyla özelleştirilebilir. Sonuç özel bir nesne olarak adlandırılır. Bir örneğe eklenen tüm Üyeler yalnızca o örneğin ömrü için mevcuttur; aynı çekirdek türünün diğer örnekleri bundan etkilenmez.

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

  • genişletilmiş tür sistemi (ETS) aracılığıyla uyarlanan Üyeler, en fazla ayrıntı belirtilmemiş.
  • genişletilmiş Üyeler, cmdlet Add-memberaracılığıyla.

PowerShell 'de, genişletilmiş Üyeler dosyalar aracılığıyla types.ps1xml da eklenebilir. Uyarlanan ve genişletilmiş üyelere topluca yapay Üyeler denir.

ETS, tüm PowerShell nesnelerine aşağıdaki üyeleri ekler: psbase, psadapted, psextended ve pstypenames. Bu üyeler hakkında daha fazla bilgi için bkz. Get-member içindeki zorunlu ve görüntüleme parametreleri.

Örnek üye, aynı ada sahip bir genişletilmiş ve/veya uyarlanan üyeyi gizleyebilir ve genişletilmiş bir üye bir uyarüyesini gizleyebilir. Bu gibi durumlarda, üye, gizli üyelere erişmek için psadapted ve psextended olarak ayarlanır.

Bir bir types.ps1xml üyesini, destekler adlı bir üyeyi belirtiyorsa, ile Add-Member eklenen bir üyeye değil, obj.psextended yalnızca o üyeye erişim sağlar.

Yeni bir üyeye sahip bir özel nesne oluşturmak için üç yol 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 üyelerini eklemek için kullanılabilir.

    $x = New-Module -AsCustomObject {$M = 123 ; Export-ModuleMember --Variable M}`
    
  3. Bu yaklaşım, herhangi bir tür üye 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.