Get-Content

Sintaxe

Path (Predefinição)

Get-Content
    [-Path] <string[]>
    [-ReadCount <long>]
    [-TotalCount <long>]
    [-Tail <int>]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-UseTransaction]
    [-Delimiter <string>]
    [-Wait]
    [-Raw]
    [-Encoding <FileSystemCmdletProviderEncoding>]
    [-Stream <string>]
    [<CommonParameters>]

LiteralPath

Get-Content
    -LiteralPath <string[]>
    [-ReadCount <long>]
    [-TotalCount <long>]
    [-Tail <int>]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-UseTransaction]
    [-Delimiter <string>]
    [-Wait]
    [-Raw]
    [-Encoding <FileSystemCmdletProviderEncoding>]
    [-Stream <string>]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Obter o conteúdo de um ficheiro de texto

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.

Exemplo 2: Limitar o número de linhas que Get-Content retorna

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

Exemplo 3: Obter uma linha específica de conteúdo de um arquivo de texto

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

This is Line 25

Exemplo 4: Obter a última linha de um arquivo de texto

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

This is Line 100

Exemplo 5: Obter o conteúdo de um fluxo de dados alternativo

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, or $DATA stream.
Get-Content -Path .\Stream.txt -Stream $DATA

This is the content of the Stream.txt file

# Use the Stream parameter of Add-Content to create a new Stream containing sample content.
Add-Content -Path .\Stream.txt -Stream NewStream -Value 'Added a stream named NewStream to Stream.txt'
# 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

Exemplo 6: Obter conteúdo bruto

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

Exemplo 7: Usar filtros com Get-Content

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

Exemplo 8: Obter o conteúdo do arquivo como uma matriz de bytes

$byteArray = Get-Content -Path C:\temp\test.txt -Encoding Byte -Raw
Get-Member -InputObject $bytearray

   TypeName: System.Byte[]

Name           MemberType            Definition
----           ----------            ----------
Count          AliasProperty         Count = Length
Add            Method                int IList.Add(System.Object value)

Parâmetros

-Credential

Propriedades dos parâmetros

Conjuntos de parâmetros

-Delimiter

Especifica o delimitador que Get-Content usa para dividir o arquivo em objetos enquanto ele lê. O padrão é \n, o caractere de fim de linha. Ao ler um arquivo de texto, Get-Content retorna uma coleção de objetos de cadeia de caracteres, cada um dos quais termina com um caractere de fim de linha. Quando você insere um delimitador que não existe no arquivo, Get-Content retorna o arquivo inteiro como um único objeto não delimitado.

Você pode usar esse parâmetro para dividir um arquivo grande em arquivos menores, especificando um separador de arquivo, como o delimitador. O delimitador é preservado (não descartado) e se torna o último item em cada seção de arquivo.

Delimitador é um parâmetro dinâmico que o provedor de FileSystem adiciona ao cmdlet Get-Content. Este parâmetro funciona apenas em unidades de disco do sistema de arquivos.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Encoding

Especifica o tipo de codificação para o arquivo de destino. O valor padrão é Default.

Os valores aceitáveis para este parâmetro são os seguintes:

• ASCII usa o conjunto de caracteres ASCII (7 bits).
• BigEndianUnicode usa UTF-16 com a ordem de bytes big-endian.
• BigEndianUTF32 usa UTF-32 com a ordem de bytes big-endian.
• Byte Codifica um conjunto de caracteres em uma sequência de bytes.
• Default Usa a codificação que corresponde à página de código ativa do sistema (geralmente ANSI).
• OEM Usa a codificação que corresponde à página de código OEM atual do sistema.
• String mesmo que Unicode.
• Unicode Usa UTF-16 com a ordem de bytes little-endian.
• desconhecido mesmo que Unicode.
• UTF7 usa UTF-7.
• UTF8 usa UTF-8.
• UTF32 Usa UTF-32 com a ordem de bytes little-endian.

A codificação é um parâmetro dinâmico que o provedor de FileSystem adiciona ao cmdlet Get-Content. Este parâmetro funciona apenas em unidades de disco do sistema de arquivos.

Ao ler e gravar em arquivos binários, use um valor de Byte para o parâmetro dinâmico Encoding e um valor 0 para o parâmetro ReadCount. Um ReadCount valor 0 lê o arquivo inteiro em uma única operação de leitura e o converte em um único objeto (PSObject). O valor padrão do ReadCount, 1, lê um byte em cada operação de leitura e converte cada byte em um objeto separado, o que causa erros quando você usa o cmdlet Set-Content para gravar os bytes em um arquivo.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Exclude

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet exclui na operação. O valor desse parâmetro qualifica o parâmetro Path.

Insira um elemento ou padrão de caminho, como *.txt. Caracteres coringa são permitidos.

O parâmetro Exclude só é efetivo quando o comando inclui o conteúdo de um item, como C:\Windows\*, onde o caractere curinga especifica o conteúdo do diretório C:\Windows.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Filter

Especifica um filtro para qualificar o parâmetro Path. O provedor FileSystem é o único provedor do PowerShell instalado que oferece suporte ao uso de filtros. A sintaxe da linguagem de filtro do FileSystem pode ser encontrada em about_Wildcards. Os filtros são mais eficientes do que outros parâmetros, porque o provedor os aplica quando o cmdlet obtém os objetos em vez de fazer com que o PowerShell filtre os objetos depois que eles são recuperados.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Force

Force substituirá um atributo somente leitura ou criará diretórios para concluir um caminho de arquivo. O parâmetro Force não tenta alterar permissões de arquivo ou substituir restrições de segurança.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Include

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet inclui na operação. O valor desse parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como "*.txt". Caracteres coringa são permitidos. O parâmetro Include só é efetivo quando o comando inclui o conteúdo de um item, como C:\Windows\*, onde o caractere curinga especifica o conteúdo do diretório C:\Windows.

Propriedades dos parâmetros

Conjuntos de parâmetros

-LiteralPath

Especifica um caminho para um ou mais locais. O valor de LiteralPath é utilizado exatamente como foi escrito. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.

Para obter mais informações, consulte about_Quoting_Rules.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Path

Especifica o caminho para um item onde Get-Content obtém o conteúdo. Caracteres coringa são permitidos. Os caminhos devem ser caminhos para itens, não para contêineres. Por exemplo, você deve especificar um caminho para um ou mais arquivos, não um caminho para um diretório.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Raw

Ignora caracteres de nova linha e retorna todo o conteúdo de um arquivo em uma cadeia de caracteres com as novas linhas preservadas. Por padrão, caracteres de nova linha em um arquivo são usados como delimitadores para separar a entrada em uma matriz de cadeias de caracteres. Esse parâmetro foi introduzido no PowerShell 3.0.

Raw é um parâmetro dinâmico que o provedor FileSystem adiciona ao cmdlet Get-Content Este parâmetro funciona apenas em unidades do sistema de ficheiros.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ReadCount

Especifica quantas linhas de conteúdo são enviadas pelo pipeline de cada vez. O valor padrão é 1. Um valor de 0 (zero) envia todo o conteúdo de uma só vez.

Esse parâmetro não altera o conteúdo exibido, mas afeta o tempo necessário para exibir o conteúdo. À medida que o valor de ReadCount aumenta, o tempo necessário para retornar a primeira linha aumenta, mas o tempo total para a operação diminui. Isso pode fazer uma diferença percetível em itens grandes.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Stream

Obtém o conteúdo do fluxo de arquivo NTFS alternativo especificado do arquivo. Insira o nome do fluxo. Não há suporte para curingas.

Stream é um parâmetro dinâmico que o provedor FileSystem adiciona ao cmdlet Get-Content. Este parâmetro funciona apenas em unidades de sistema de arquivos em sistemas Windows. Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Tail

Especifica o número de linhas do final de um arquivo ou outro item. Você pode usar o nome do parâmetro Tail ou o seu alias, Last. Esse parâmetro foi introduzido no PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-TotalCount

Especifica o número de linhas desde o início de um arquivo ou outro item. O padrão é -1 (todas as linhas).

Pode usar o nome do parâmetro TotalCount ou os seus aliases, First ou Head.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UseTransaction

Inclui o comando na transação ativa. Este parâmetro é válido somente quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Wait

Mantém o arquivo aberto depois que todas as linhas existentes foram saídas. Enquanto espera, Get-Content verifica o arquivo uma vez a cada segundo e gera novas linhas, se presente. Você pode interromper Wait pressionando CTRL+C. A espera também termina se o arquivo for excluído, caso em que um erro não terminativo é relatado.

Wait é um parâmetro dinâmico que o provedor FileSystem adiciona ao cmdlet Get-Content. Este parâmetro funciona apenas em unidades de disco do sistema de arquivos. Aguarde não pode ser combinado com Raw.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

System.Int64, System.String

Saídas

System.Byte, System.String

Notas

Ligações Relacionadas

• Sobre as Variáveis Automáticas
• sobre_Fornecedores
• Adicionar Conteúdo
• Limpar Conteúdo
• ForEach-Object
• Get-PSProvider
• Set-Content