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ı) |
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.PathInfoStack
tü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.IEnumerator
tü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 $foreach
bu tür: System.Array+SZArrayEnumerator
. için $input
bu tür: System.Collections.ArrayList+ArrayListEnumeratorSimple
. için $switch
bu 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:
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 üyelerini eklemek için kullanılabilir.
$x = New-Module -AsCustomObject {$M = 123 ; Export-ModuleMember --Variable M}`
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.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin