Get-Content

Syntaxe

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

L’applet Get-Content de commande obtient le contenu de l’élément à l’emplacement spécifié par le chemin d’accès, tel que le texte d’un fichier ou le contenu d’une fonction. Pour les fichiers, le contenu est lu une ligne à la fois et retourne une collection d’objets, chacune représentant une ligne de contenu.

À compter de PowerShell 3.0, Get-Content vous pouvez également obtenir un nombre spécifié de lignes à partir du début ou de la fin d’un élément.

Exemples

Exemple 1 : Obtenir le contenu d’un fichier texte

Cet exemple obtient le contenu d’un fichier dans le répertoire actif. Le LineNumbers.txt fichier comporte 100 lignes au format, il s’agit de ligne X et est utilisé dans plusieurs exemples.

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.

Les valeurs de tableau 1 à 100 sont envoyées au pipeline à l’applet ForEach-Object de commande. ForEach-Object utilise un bloc de script avec l’applet Add-Content de commande pour créer le LineNumbers.txt fichier. La variable $_ représente les valeurs de tableau à mesure que chaque objet est envoyé vers le bas du pipeline. L’applet Get-Content de commande utilise le paramètre Path pour spécifier le LineNumbers.txt fichier et afficher le contenu dans la console PowerShell.

Exemple 2 : Limiter le nombre de lignes renvoyées par Get-Content

Cette commande obtient les cinq premières lignes d’un fichier. Le paramètre TotalCount obtient les cinq premières lignes de contenu. Cet exemple utilise la LineNumbers.txt référence dans l’exemple 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

Exemple 3 : Obtenir une ligne de contenu spécifique à partir d’un fichier texte

Cette commande obtient un nombre spécifique de lignes d’un fichier, puis affiche uniquement la dernière ligne de ce contenu. Le paramètre TotalCount obtient les 25 premières lignes de contenu. Cet exemple utilise le fichier référencé dans l’exemple LineNumbers.txt 1.

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

This is Line 25

La Get-Content commande est encapsulée entre parenthèses afin que la commande se termine avant de passer à l’étape suivante. Get-Contentretourne un tableau de lignes, ce qui vous permet d’ajouter la notation d’index après la parenthèse pour récupérer un numéro de ligne spécifique. Dans ce cas, l’index [-1] spécifie le dernier index dans le tableau retourné de 25 lignes récupérées.

Exemple 4 : Obtenir la dernière ligne d’un fichier texte

Cette commande obtient la dernière ligne de contenu d’un fichier. Cet exemple utilise le LineNumbers.txt fichier créé dans l’exemple 1.

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

This is Line 100

Cet exemple utilise l’applet Get-Item de commande pour illustrer que vous pouvez diriger des fichiers vers Get-Content. Le paramètre Tail obtient la dernière ligne du fichier. Cette méthode est plus rapide que la récupération de toutes les lignes d’une variable et l’utilisation de la notation d’index [-1] .

Exemple 5 : Obtenir le contenu d’un autre flux de données

Cet exemple explique comment utiliser le paramètre Stream pour obtenir le contenu d’un autre flux de données pour les fichiers stockés sur un volume NTFS Windows. Dans cet exemple, l’applet Set-Content de commande est utilisée pour créer un exemple de contenu dans un fichier nommé 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

Le paramètre Stream est un paramètre dynamique du fournisseur FileSystem. Par défaut, il récupère uniquement les données à partir de la valeur par défaut Get-Content ou :$DATA du flux. Les flux peuvent être utilisés pour stocker des données masquées telles que des attributs, des paramètres de sécurité ou d’autres données. Ils peuvent également être stockés sur des répertoires sans être des éléments enfants.

Exemple 6 : Obtenir du contenu brut

Les commandes de cet exemple obtiennent le contenu d’un fichier sous la forme d’une seule chaîne, au lieu d’un tableau de chaînes. Par défaut, sans paramètre dynamique Brut, le contenu est retourné sous la forme d’un tableau de chaînes délimitées par une ligne. Cet exemple utilise le fichier référencé dans l’exemple LineNumbers.txt 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.

Exemple 7 : Utiliser des filtres avec Get-Content

Vous pouvez spécifier un filtre à l’applet Get-Content de commande. Lorsque vous utilisez des filtres pour qualifier le paramètre Path , vous devez inclure un astérisque de fin (*) pour indiquer le contenu du chemin.

La commande suivante obtient le contenu de tous les *.log fichiers du C:\Temp répertoire.

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

Exemple 8 : Obtenir le contenu du fichier en tant que tableau d’octets

Cet exemple montre comment obtenir le contenu d’un fichier en tant qu’objet [byte[]] unique.

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

La première commande utilise le paramètre AsByteStream pour obtenir le flux d’octets du fichier. Le paramètre Raw garantit que les octets sont retournés en tant que [System.Byte[]]. Si le paramètre Raw était absent, la valeur de retour est un flux d’octets, interprété par PowerShell comme [System.Object[]].

Paramètres

-AsByteStream

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-Wait

Entrées

Int64

Vous pouvez diriger le nombre de lectures ou le nombre total vers cette applet de commande.

String[]

Vous pouvez diriger les chemins vers cette applet de commande.

PSCredential

Vous pouvez diriger les informations d’identification vers cette applet de commande.

Sorties

Byte

Lorsque vous utilisez le paramètre AsByteStream , cette applet de commande retourne le contenu sous forme d’octets.

String

Par défaut, cette applet de commande retourne le contenu sous forme de tableau de chaînes, une par ligne. Lorsque vous utilisez le paramètre Raw , il retourne une chaîne unique contenant chaque ligne du fichier.

Notes

PowerShell inclut les alias suivants pour Get-Content:

• Toutes les plateformes :
  • gc
  • type
• Windows :
  • cat

L’applet Get-Content de commande est conçue pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour obtenir les fournisseurs dans votre session, utilisez l’applet de Get-PSProvider commande. Pour plus d’informations, consultez about_Providers.

Liens associés

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