Get-Content
Belirtilen konumda öğenin içeriğini alır.
Sözdizimi
Path EnterprisePublishing
Get-Content
[-Path] <String[]>
[-ReadCount <Int64>]
[-TotalCount <Int64>]
[-Tail <Int32>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Delimiter <String>]
[-Wait]
[-Raw]
[-Encoding <Encoding>]
[-AsByteStream]
[-Stream <String>]
[<CommonParameters>]
LiteralPath
Get-Content
-LiteralPath <String[]>
[-ReadCount <Int64>]
[-TotalCount <Int64>]
[-Tail <Int32>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Delimiter <String>]
[-Wait]
[-Raw]
[-Encoding <Encoding>]
[-AsByteStream]
[-Stream <String>]
[<CommonParameters>]
Description
Get-Content cmdlet'i, yolun belirttiği konumdaki öğenin içeriğini, örneğin bir dosyadaki metni veya bir işlevin içeriğini alır. Dosyalar için içerik her seferinde bir satır okunur ve her biri bir içerik satırını temsil eden bir nesne koleksiyonu döndürür.
PowerShell 3.0'dan başlayarak, Get-Content bir öğenin başından veya sonundan belirtilen sayıda satır da alabilir.
Örnekler
Örnek 1: Metin dosyasının içeriğini alma
Bu örnek, geçerli dizindeki bir dosyanın içeriğini alır.
LineNumbers.txt dosyasının biçiminde 100 satır vardır Bu X. Satır ve çeşitli örneklerde kullanılır.
1..100 | ForEach-Object {
Add-Content -Path .\LineNumbers.txt -Value "This is line $_."
}
Get-Content -Path .\LineNumbers.txt
This is Line 1
This is Line 2
...
This is line 99.
This is line 100.
1-100 arasındaki dizi değerleri, işlem hattına ForEach-Object cmdlet'ine gönderilir.
ForEach-Object, Add-Content dosyasını oluşturmak için LineNumbers.txt cmdlet'iyle bir betik bloğu kullanır.
$_ değişkeni, her nesne işlem hattına gönderilirken dizi değerlerini temsil eder.
Get-Content cmdlet'i, dosyasını belirtmek için LineNumbers.txt parametresini kullanır ve içeriği PowerShell konsolunda görüntüler.
Örnek 2: Get-Content'ın döndürdüğü satır sayısını sınırlayın
Bu komut dosyanın ilk beş satırını alır.
TotalCount parametresi ilk beş içerik satırını alır. Bu örnek, Örnek 1'de atıfta bulunan LineNumbers.txt'ı kullanır.
Get-Content -Path .\LineNumbers.txt -TotalCount 5
This is Line 1
This is Line 2
This is Line 3
This is Line 4
This is Line 5
Örnek 3: Metin dosyasından belirli bir içerik satırı alma
Bu komut bir dosyadan belirli sayıda satır alır ve ardından bu içeriğin yalnızca son satırını görüntüler.
TotalCount parametresi ilk 25 içerik satırını alır. Bu örnek, Örnek 1'de başvuruda bulunılan LineNumbers.txt dosyasını kullanır.
(Get-Content -Path .\LineNumbers.txt -TotalCount 25)[-1]
This is Line 25
Get-Content komutu parantez içinde sarmalanır, böylece komut bir sonraki adıma geçmeden önce tamamlanır.
Get-Contentbir dizi satır döndürür; bu, belirli bir satır numarasını almak için parantezden sonra dizin gösterimini eklemenize olanak tanır. Bu durumda, [-1] dizini döndürülen 25 satırlık dizideki son dizini belirtir.
Örnek 4: Metin dosyasının son satırını alma
Bu komut bir dosyadan son içerik satırını alır. Bu örnek, Örnek 1'de oluşturulan LineNumbers.txt dosyasını kullanır.
Get-Item -Path .\LineNumbers.txt | Get-Content -Tail 1
This is Line 100
Bu örnekte dosyaları Get-Itemkanalla aktarabileceğinizi göstermek için Get-Content cmdlet'i kullanılır.
Tail parametresi dosyanın son satırını alır. Bu yöntem, bir değişkendeki tüm satırları almaktan ve [-1] dizin gösterimini kullanmaktan daha hızlıdır.
Örnek 5: Alternatif veri akışının içeriğini alma
Bu örnekte, Windows NTFS biriminde depolanan dosyalar için alternatif bir veri akışının içeriğini almak için Stream parametresinin nasıl kullanılacağı açıklanmaktadır. Bu örnekte, Set-Content cmdlet'i Stream.txtadlı bir dosyada örnek içerik oluşturmak için kullanılır.
Set-Content -Path .\Stream.txt -Value 'This is the content of the Stream.txt file'
# Specify a wildcard to the Stream parameter to display all streams of the recently
# created file.
Get-Item -Path .\Stream.txt -Stream *
PSPath : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName : Stream.txt::$DATA
PSDrive : C
PSProvider : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName : C:\Test\Stream.txt
Stream : :$DATA
Length : 44
# Retrieve the content of the primary stream.
# Note the single quotes to prevent variable substitution.
Get-Content -Path .\Stream.txt -Stream ':$DATA'
This is the content of the Stream.txt file
# Alternative way to get the same content.
Get-Content -Path .\Stream.txt -Stream ""
# The primary stream doesn't need to be specified to get the primary stream of the file.
# This gets the same data as the prior two examples.
Get-Content -Path .\Stream.txt
This is the content of the Stream.txt file
# Use the Stream parameter of Add-Content to create a new Stream containing sample
# content.
$addContentSplat = @{
Path = '.\Stream.txt'
Stream = 'NewStream'
Value = 'Added a stream named NewStream to Stream.txt'
}
Add-Content @addContentSplat
# Use Get-Item to verify the stream was created.
Get-Item -Path .\Stream.txt -Stream *
PSPath : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName : Stream.txt::$DATA
PSDrive : C
PSProvider : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName : C:\Test\Stream.txt
Stream : :$DATA
Length : 44
PSPath : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt:NewStream
PSParentPath : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName : Stream.txt:NewStream
PSDrive : C
PSProvider : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName : C:\Test\Stream.txt
Stream : NewStream
Length : 46
# Retrieve the content of your newly created Stream.
Get-Content -Path .\Stream.txt -Stream NewStream
Added a stream named NewStream to Stream.txt
Stream parametresi, FileSystem sağlayıcısınındinamik bir parametresidir.
Varsayılan olarak Get-Content yalnızca varsayılan veya :$DATA akışından veri alır.
Streams öznitelikler, güvenlik ayarları veya diğer veriler gibi gizli verileri depolamak için kullanılabilir. Bunlar, alt öğeler olmadan da dizinlerde saklanabilir.
Örnek 6: Ham içerik alma
Bu örnekteki komutlar, bir dize dizisi yerine dosyanın içeriğini tek bir dize olarak alır. Varsayılan olarak, Raw dinamik parametresi olmadan içerik, yeni satırla ayrılmış dize dizisi olarak döndürülür. Bu örnek, Örnek 1'de başvuruda bulunılan LineNumbers.txt dosyasını kullanır.
$raw = Get-Content -Path .\LineNumbers.txt -Raw
$lines = Get-Content -Path .\LineNumbers.txt
Write-Host "Raw contains $($raw.Count) lines."
Write-Host "Lines contains $($lines.Count) lines."
Raw contains 1 lines.
Lines contains 100 lines.
Örnek 7: filtreleri Get-Content ile kullanma
Get-Content cmdlet'ine bir filtre belirtebilirsiniz.
Yolu parametresini niteleme amacıyla filtreler kullanırken, yolun içeriğini göstermek için sondaki yıldız işareti (*) eklemeniz gerekir.
Aşağıdaki komut, *.log dizinindeki tüm C:\Temp dosyalarının içeriğini alır.
Get-Content -Path C:\Temp\* -Filter *.log
Örnek 8: Dosya içeriğini bayt dizisi olarak alma
Bu örnek, bir dosyanın içeriğinin [byte[]] olarak tek bir nesne halinde nasıl alınacağını göstermektedir.
$byteArray = Get-Content -Path C:\temp\test.txt -AsByteStream -Raw
Get-Member -InputObject $byteArray
TypeName: System.Byte[]
Name MemberType Definition
---- ---------- ----------
Count AliasProperty Count = Length
Add Method int IList.Add(System.Object value)
İlk komut, dosyadan bayt akışını almak için AsByteStream parametresini kullanır.
Raw parametresi baytların [System.Byte[]]olarak döndürülmesini sağlar.
Raw parametresi yoksa, dönüş değeri PowerShell tarafından [System.Object[]]olarak yorumlanan bir bayt akışıdır.
Parametreler
-AsByteStream
İçeriğin bayt akışı olarak okunması gerektiğini belirtir. AsByteStream parametresi Windows PowerShell 6.0'da kullanıma sunulmuştur.
Kodlama parametresiyle AsByteStream parametresini kullandığınızda bir uyarı oluşur. AsByteStream parametresi tüm kodlamaları yoksayar ve çıkış bayt akışı olarak döndürülür.
İkili dosyalardan okurken ve ikili dosyalara yazarken AsByteStream parametresini ve ReadCount parametresi için 0 değerini kullanın.
ReadCount değeri 0 tek bir okuma işleminde dosyanın tamamını okur. Varsayılan ReadCount değeri olan 1, her okuma işleminde bir bayt okur ve her baytı ayrı bir nesneye dönüştürür. Tek baytlık çıktıyı Set-Content'a yönlendirdiğinizde, ile Set-Content parametresini kullanmadığınız sürece hatalara neden olur.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Uyarı
Bu parametre, PowerShell ile yüklenen sağlayıcılar tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Commandkullanın.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Delimiter
Get-Content dosyayı okurken nesnelere bölmek için kullandığı sınırlayıcıyı belirtir. Varsayılan değer \nsatır sonu karakteridir. Bir metin dosyasını okurken, Get-Content her biri satır sonu karakteriyle biten dize nesnelerinden oluşan bir koleksiyon döndürür. Dosyada var olmayan bir sınırlayıcı girdiğinizde, Get-Content dosyanın tamamını tek ve etkilenmemiş bir nesne olarak döndürür.
Sınırlayıcı olarak bir dosya ayırıcısı belirterek büyük bir dosyayı daha küçük dosyalara bölmek için bu parametreyi kullanabilirsiniz. Sınırlayıcı korunur (atılmaz) ve her dosya bölümündeki son öğe olur.
Sınırlayıcı, FileSystem sağlayıcısının Get-Content cmdlet'ine eklediği dinamik bir parametredir. Bu parametre yalnızca dosya sistemi sürücülerinde çalışır.
Uyarı
Şu anda, Sınırlayıcı parametresinin değeri boş bir dize olduğunda Get-Content hiçbir şey döndürmez. Bu bilinen bir sorundur.
Get-Content'ı dosyanın tamamını tek bir ayrılmamış dize olarak döndürmeye zorlamak için. Dosyada var olmayan bir değer girin.
Parametre özellikleri
| Tür: | String |
| Default value: | End-of-line character |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Encoding
Hedef dosya için kodlama türünü belirtir. Varsayılan değer şudur: utf8NoBOM.
Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:
-
ascii: ASCII (7 bit) karakter kümesi için kodlamayı kullanır. -
ansi: Geçerli kültürün ANSI kod sayfasının kodlamasını kullanır. Bu seçenek PowerShell 7.4'e eklendi. -
bigendianunicode: Büyük endian bayt sırasını kullanarak UTF-16 biçiminde kodlar. -
bigendianutf32: Büyük endian bayt sırasını kullanarak UTF-32 biçiminde kodlar. -
oem: MS-DOS ve konsol programları için varsayılan kodlamayı kullanır. -
unicode: Küçük-öncelikli bayt sırası kullanılarak UTF-16 biçiminde kodlanır. -
utf7: UTF-7 biçiminde kodlar. -
utf8: UTF-8 biçiminde kodlar. -
utf8BOM: Bayt Sırası İşareti (BOM) ile UTF-8 biçiminde kodlar -
utf8NoBOM: Bayt Sırası İşareti (BOM) olmadan UTF-8 biçiminde kodlar -
utf32: UTF-32 biçiminde kodlar.
Kodlama, FileSystem sağlayıcısının Get-Content cmdlet'ine eklediği dinamik bir parametredir.
Bu parametre yalnızca dosya sistemi sürücülerinde kullanılabilir.
PowerShell 6.2'den başlayarak, Kodlama parametresi, kayıtlı kod sayfalarının sayısal kimliklerine (-Encoding 1251gibi) veya kayıtlı kod sayfalarının dize adlarına (-Encoding "windows-1251"gibi) de izin verir. Daha fazla bilgi için Encoding.CodePageiçin .NET belgelerine bakın.
PowerShell 7.4'den başlayarak, Ansi parametresinin değerini kullanarak geçerli kültürün ANSI kod sayfasının sayısal kimliğini el ile belirtmek zorunda kalmadan geçirebilirsiniz.
Uyarı
UTF-7* artık kullanılması önerilmez. PowerShell 7.1'den itibaren, utf7 parametresi için belirtirseniz bir uyarı yazılır.
Parametre özellikleri
| Tür: | Encoding |
| Default value: | UTF8NoBOM |
| Kabul edilen değerler: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Exclude
Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler.
*.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.
Exclude parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter C:\Windows dizininin içeriğini belirtir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Filter
Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin sözdizimini about_Wildcards'de bulabilirsiniz. Filtreler, sağlayıcı komut dosyası çalıştırma aracı nesneleri alırken bunları uyguladığı için, diğer parametrelerden daha verimlidir; bu sayede PowerShell nesneler alındıktan sonra bunları filtrelemek zorunda kalmaz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Force salt okunur bir özelliği geçersiz kılabilir veya bir dosya yolunu tamamlamak için dizinler oluşturur. Zorla parametresi, dosya izinlerini değiştirmeye veya güvenlik kısıtlamalarını geçersiz kılmaya çalışmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Include
Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler.
"*.txt"gibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.
Include parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde ve joker karakteri C:\Windows dizininin içeriğini belirttiğinde etkilidir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-LiteralPath
Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.
Daha fazla bilgi için bkz. about_Quoting_Rules.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
LiteralPath
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Get-Content içeriği aldığı öğenin konumunu belirtir. Joker karakterlere izin verilir. Yollar kapsayıcılara değil öğelere giden yollar olmalıdır. Örneğin, dizin yolu değil, bir veya daha fazla dosya için yol belirtmeniz gerekir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Path
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Raw
Yeni satır karakterlerini yoksayar ve bir dizedeki dosyanın tüm içeriğini yeni satırlar korunarak döndürür. Varsayılan olarak, bir dosyadaki yeni satır karakterleri girişi dize dizisine ayırmak için sınırlayıcı olarak kullanılır. Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Raw, FileSystem sağlayıcısının Get-Content cmdlet'ine eklediği dinamik bir parametredir. Bu parametre yalnızca dosya sistemi sürücülerinde çalışır.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ReadCount
İşlem hattı üzerinden aynı anda kaç satır içerik gönderileceğini belirtir. Varsayılan değer 1'dir. 0 (sıfır) veya negatif sayı değeri, tüm içeriği bir kerede gönderir.
Bu parametre görüntülenen içeriği değiştirmez, ancak içeriğin görüntülenmesi için gereken süreyi etkiler. ReadCount değeri arttıkça, ilk satırı döndürmek için gereken süre artar, ancak işlemin toplam süresi azalır. Bu, büyük öğelerde algılanabilir bir fark oluşturabilir.
Parametre özellikleri
| Tür: | Int64 |
| Default value: | 1 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Stream
Uyarı
Bu Parametre yalnızca Windows'da kullanılabilir.
Belirtilen alternatif NTFS dosya akışının içeriğini dosyadan alır. Akış adını girin. Joker karakterler desteklenmez.
Stream, FileSystem sağlayıcısının Get-Content cmdlet'ine eklediği dinamik bir parametredir.
Bu parametre yalnızca Windows sistemlerindeki dosya sistemi sürücülerinde çalışır.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur. PowerShell 7.2'de Get-Content hem dizinlerden hem de dosyalardan alternatif veri akışlarının içeriğini alabilir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Tail
Bir dosyanın veya başka bir öğenin sonundaki satır sayısını belirtir.
Tail parametre adını veya takma adı olarak Sonkullanabilirsiniz.
0 değeri herhangi bir satır üretmez. Negatif değerler hataya neden olur.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Son |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-TotalCount
Bir dosyanın veya başka bir öğenin başındaki satır sayısını belirtir.
0 değeri herhangi bir satır üretmez. Negatif değerler hataya neden olur.
TotalCount parametre adını veya bunun diğer adlarını, First ya da Head, kullanabilirsiniz.
Parametre özellikleri
| Tür: | Int64 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | İlk, Baş |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Wait
Cmdlet'in kesintiye uğrayana kadar dosyayı açık tutarak süresiz beklemesine neden olur. beklerken Get-Content saniyede bir dosyayı denetler ve varsa yeni satırlar oluşturur.
TotalCount parametresiyle kullanıldığında, Get-Content belirtilen dosyada belirtilen satır sayısı kullanılabilir olana kadar bekler. Örneğin, 10 TotalCount belirtirseniz ve dosyada zaten 10 veya daha fazla satır varsa, Get-Content 10 satır döndürür ve işlemden çıkar. Dosyada 10'dan az satır varsa, Get-Content her satır geldiğinde satırı çıktı verir, ancak çıkmadan önce onuncu satırın gelmesini bekler.
Ctrl+tuşlarına basarak Bekleme kesebilirsiniz. Dosyanın silinmesi, beklemeyi de kesen sonlandırıcı olmayan bir hataya neden olur.
Wait, FileSystem sağlayıcısının Get-Content cmdlet'ine eklediği dinamik bir parametredir. Bu parametre yalnızca dosya sistemi sürücülerinde çalışır.
BekleRawile birleştirilemiyor.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
Int64
Okuma sayısını veya toplam sayısını bu cmdlet'e yönlendirebilirsiniz.
String
Yolları bu cmdlet'e yöneltebilirsiniz.
PSCredential
Kimlik bilgilerini bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
Byte
AsByteStream parametresini kullandığınızda, bu cmdlet içeriği bayt olarak döndürür.
String
Varsayılan olarak, bu cmdlet içeriği satır başına bir dize dizisi olarak döndürür. Raw parametresini kullandığınızda, dosyadaki her satırı içeren tek bir dize döndürür.
Notlar
PowerShell, Get-Contentiçin aşağıdaki diğer adları içerir:
- Tüm platformlar:
gctype
- Windows:
cat
Get-Content cmdlet'i herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Sağlayıcıları oturumunuza almak için Get-PSProvider cmdlet'ini kullanın. Daha fazla bilgi için bkz. about_Providers.
