Get-Content

Sintassi

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>]

Descrizione

Il Get-Content cmdlet ottiene il contenuto dell'elemento nel percorso specificato dal percorso, ad esempio il testo in un file o il contenuto di una funzione. Per i file, il contenuto viene letto una riga alla volta e restituisce una raccolta di oggetti, ognuno che rappresenta una riga di contenuto.

A partire da PowerShell 3.0, Get-Content può anche ottenere un numero specificato di righe dall'inizio o dalla fine di un elemento.

Esempio

Esempio 1: Ottenere il contenuto di un file di testo

In questo esempio viene restituito il contenuto di un file nella directory corrente. Il LineNumbers.txt file ha 100 righe nel formato, Questo è Line X e viene usato in diversi esempi.

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.

I valori della matrice 1-100 vengono inviati alla pipeline al ForEach-Object cmdlet . ForEach-Object usa un blocco di script con il Add-Content cmdlet per creare il LineNumbers.txt file. La variabile $_ rappresenta i valori della matrice man mano che ogni oggetto viene inviato alla pipeline. Il Get-Content cmdlet usa il parametro Path per specificare il LineNumbers.txt file e visualizza il contenuto nella console di PowerShell.

Esempio 2: Limitare il numero di righe restituite da Get-Content

Questo comando ottiene le prime cinque righe di un file. Il parametro TotalCount ottiene le prime cinque righe di contenuto. In questo esempio viene usato il riferimento nell'esempio LineNumbers.txt 1.

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

Esempio 3: Ottenere una riga di contenuto specifica da un file di testo

Questo comando ottiene un numero specifico di righe da un file e quindi visualizza solo l'ultima riga del contenuto. Il parametro TotalCount ottiene le prime 25 righe di contenuto. In questo esempio viene usato il LineNumbers.txt file a cui viene fatto riferimento nell'esempio 1.

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

This is Line 25

Il Get-Content comando viene racchiuso tra parentesi in modo che il comando venga completato prima di passare al passaggio successivo. Get-Contentrestituisce una matrice di righe, che consente di aggiungere la notazione dell'indice dopo la parentesi per recuperare un numero di riga specifico. In questo caso, l'indice [-1] specifica l'ultimo indice nella matrice restituita di 25 righe recuperate.

Esempio 4: Ottenere l'ultima riga di un file di testo

Questo comando ottiene l'ultima riga di contenuto da un file. In questo esempio viene usato il LineNumbers.txt file creato nell'esempio 1.

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

This is Line 100

In questo esempio viene usato il Get-Item cmdlet per dimostrare che è possibile inviare tramite pipe i file a Get-Content. Il parametro Tail ottiene l'ultima riga del file. Questo metodo è più veloce rispetto al recupero di tutte le righe in una variabile e all'uso della notazione dell'indice [-1] .

Esempio 5: Ottenere il contenuto di un flusso di dati alternativo

Questo esempio descrive come usare il parametro Stream per ottenere il contenuto di un flusso di dati alternativo per i file archiviati in un volume NTFS di Windows. In questo esempio viene usato il Set-Content cmdlet per creare contenuto di esempio in un file denominato Stream.txt.

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

Il parametro Stream è un parametro dinamico del provider FileSystem. Per impostazione predefinita Get-Content , recupera solo i dati dal flusso predefinito o :$DATA . I flussi possono essere usati per archiviare dati nascosti, ad esempio attributi, impostazioni di sicurezza o altri dati. Possono anche essere archiviati nelle directory senza essere elementi figlio.

Esempio 6: Ottenere contenuto non elaborato

I comandi in questo esempio ottengono il contenuto di un file come una stringa, anziché una matrice di stringhe. Per impostazione predefinita, senza il parametro dinamico Raw , il contenuto viene restituito come matrice di stringhe delimitate da nuova riga. In questo esempio viene usato il LineNumbers.txt file a cui viene fatto riferimento nell'esempio 1.

$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.

Esempio 7: Usare filtri con Get-Content

È possibile specificare un filtro per il Get-Content cmdlet . Quando si usano filtri per qualificare il parametro Path , è necessario includere un asterisco finale (*) per indicare il contenuto del percorso.

Il comando seguente ottiene il contenuto di tutti i *.log file nella C:\Temp directory.

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

Esempio 8: Ottenere il contenuto del file come matrice di byte

In questo esempio viene illustrato come ottenere il contenuto di un file come [byte[]] singolo oggetto .

$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)

Il primo comando usa il parametro AsByteStream per ottenere il flusso di byte dal file. Il parametro Raw garantisce che i byte vengano restituiti come .[System.Byte[]] Se il parametro Raw è assente, il valore restituito è un flusso di byte, interpretato da PowerShell come [System.Object[]].

Parametri

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

Input

Int64

È possibile inviare tramite pipe il conteggio di lettura o il conteggio totale a questo cmdlet.

String[]

È possibile inviare tramite pipe i percorsi a questo cmdlet.

PSCredential

È possibile inviare tramite pipe le credenziali a questo cmdlet.

Output

Byte

Quando si usa il parametro AsByteStream , questo cmdlet restituisce il contenuto come byte.

String

Per impostazione predefinita, questo cmdlet restituisce il contenuto come matrice di stringhe, una per riga. Quando si usa il parametro Raw , restituisce una singola stringa contenente ogni riga nel file.

Note

PowerShell include gli alias seguenti per Get-Content:

• Tutte le piattaforme:
  • gc
  • type
• Windows:
  • cat

Il Get-Content cmdlet è progettato per lavorare con i dati esposti da qualsiasi provider. Per ottenere i provider nella sessione, usare il Get-PSProvider cmdlet . Per altre informazioni, vedere about_Providers.

Collegamenti correlati

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