Get-Content

Sözdizimi

Get-Content
   [-ReadCount <Int64>]
   [-TotalCount <Int64>]
   [-Tail <Int32>]
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-Delimiter <String>]
   [-Wait]
   [-Raw]
   [-Encoding <Encoding>]
   [-AsByteStream]
   [-Stream <String>]
   [<CommonParameters>]

Get-Content
   [-ReadCount <Int64>]
   [-TotalCount <Int64>]
   [-Tail <Int32>]
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-Delimiter <String>]
   [-Wait]
   [-Raw]
   [-Encoding <Encoding>]
   [-AsByteStream]
   [-Stream <String>]
   [<CommonParameters>]

Description

Get-Content Cmdlet, dosyadaki metin veya işlevin içeriği gibi yolun belirttiği konumda öğenin 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. Dosyanın LineNumbers.txt biçiminde 100 satır vardır, Bu X Satırıdı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 dizi değerleri, işlem hattına cmdlet'ine ForEach-Object gönderilir. ForEach-Objectdosyayı oluşturmak LineNumbers.txt için cmdlet'iyle Add-Content bir betik bloğu kullanır. Değişken $_ , her nesne işlem hattına gönderilirken dizi değerlerini temsil eder. Cmdlet, Get-Content path parametresini kullanarak dosyayı belirtir LineNumbers.txt ve içeriği PowerShell konsolunda görüntüler.

Örnek 2: Get-Content işlevinin döndürdüğü satır sayısını sınırlama

Bu komut dosyanın ilk beş satırını alır. TotalCount parametresi ilk beş içerik satırını alır. Bu örnekte, LineNumbers.txt Örnek 1'de başvuruda bulunan kullanılı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 dosyayı kullanır LineNumbers.txt .

(Get-Content -Path .\LineNumbers.txt -TotalCount 25)[-1]

This is Line 25

Komut Get-Content , sonraki adıma geçmeden önce tamamlanabilmesi için parantez içinde sarmalanır. Get-Contentbir satır dizisi 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 dizin, [-1] döndürülen 25 alınan satır dizisindeki 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 dosyayı kullanır LineNumbers.txt .

Get-Item -Path .\LineNumbers.txt | Get-Content -Tail 1

This is Line 100

Bu örnekte, cmdlet'ini Get-Item kullanarak dosyaları adresine Get-Contentaktarabileceğinizi gösterir. Tail parametresi dosyanın son satırını alır. Bu yöntem, bir değişkendeki tüm satırları almaktan ve dizin gösterimini kullanmaktan [-1] daha hızlıdır.

Örnek 5: Alternatif veri akışının içeriğini alma

Bu örnekte, Bir 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 cmdlet, Set-Content adlı Stream.txtbir 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ın dinamik bir parametresidir. Varsayılan olarak Get-Content yalnızca varsayılan veya :$DATA akıştan veri alır. Akışlar öznitelikler , güvenlik ayarları veya diğer veriler gibi gizli verileri depolamak için kullanılabilir. Bunlar alt öğe olmadan dizinlerde de depolanabilir.

Ö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 sınırlandırılmış dize dizisi olarak döndürülür. Bu örnek, Örnek 1'de başvuruda bulunılan dosyayı kullanır LineNumbers.txt .

$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: Get-Content ile Filtreleri Kullanma

Cmdlet'ine Get-Content bir filtre belirtebilirsiniz. Path parametresini niteleme amacıyla filtreleri kullanırken, yolun içeriğini belirtmek için sondaki yıldız işareti (*) eklemeniz gerekir.

Aşağıdaki komut dizindeki C:\Temp tüm *.log dosyaların içeriğini alır.

Get-Content -Path C:\Temp\* -Filter *.log

Örnek 8: Dosya içeriğini bayt dizisi olarak alma

Bu örnekte, bir dosyanın içeriğinin tek bir nesne olarak [byte[]] nasıl alınacakları gösterilmektedir.

$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 olarak [System.Byte[]]döndürülmesini sağlar. Raw parametresi yoksa, dönüş değeri PowerShell tarafından olarak [System.Object[]]yorumlanan bir bayt akışıdır.

Parametreler

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

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 için aşağıdaki diğer adları Get-Contentiçerir:

• Tüm platformlar:
  • gc
  • type
• Windows:
  • cat

Get-Content Cmdlet, 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 cmdlet'ini Get-PSProvider kullanın. Daha fazla bilgi için bkz . about_Providers.

İlişkili Bağlantılar

• about_Automatic_Variables
• about_Providers
• Add-Content
• Clear-Content
• ForEach-Object
• Get-PSProvider
• Set-Content