Obtém o conteúdo do item no local especificado.
Sintaxe
Get-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>] Get-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Get-Content obtém o conteúdo do item no local especificado pelo caminho, como o texto em um arquivo. Ele lê o conteúdo uma linha por vez e retorna um objeto para cada linha.
Parâmetros
-Credential <PSCredential>
Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual.
Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Exclude <string[]>
Omite os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um elemento ou padrão do caminho, como "*.txt". Os caracteres curinga são permitidos.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Filter <string>
Especifica um filtro no formato ou no idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path. A sintaxe do filtro, incluindo o uso dos caracteres curinga, depende do provedor. Os filtros são mais eficientes do que outros parâmetros porque o provedor os aplica durante a recuperação dos objetos, em vez de fazer com que o Windows PowerShell os filtre depois de recuperados.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Force
Cancela as restrições que impedem a execução do comando, simplesmente para que as alterações não comprometam a segurança. Por exemplo, Force substituirá o atributo somente leitura ou criará diretórios para completar o caminho do arquivo, mas não tentará mudar as permissões do arquivo.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Include <string[]>
Recupera apenas os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um elemento ou padrão do caminho, como "*.txt". Os caracteres curinga são permitidos.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-LiteralPath <string[]>
Especifica o caminho para um item. Ao contrário de Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Path <string[]>
Especifica o caminho de um item. Get-Content recupera o conteúdo do item. Os caracteres curinga são permitidos. O nome do parâmetro ("Path" ou "FilePath") é opcional.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-ReadCount <Int64>
Especifica a quantidade de linhas do conteúdo que será envida pelo pipeline de uma só vez. O valor padrão é 1. O valor 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 decorrido para a exibição. Como o valor de ReadCount aumenta, o tempo decorrido para retornar a primeira linha aumenta, mas o tempo total para a operação diminui. Isso pode fazer uma diferença perceptível em itens muito grandes.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-TotalCount <Int64>
Especifica a quantidade de linhas do conteúdo que será recuperada. O padrão é -1 (todas as linhas).
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
None Não é possível enviar a entrada para Get-Content. |
|
Saídas |
Object Get-Content retorna objetos que representam o conteúdo obtido. O tipo do objeto depende do tipo de conteúdo. |
Observações
Você também pode se referir a Get-Content usando seu aliases internos, "cat", "type" e "gc". Para obter mais informações, consulte about_Aliases.
O cmdlet Get-Content foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PsProvider". Para obter mais informações, consulte about_Providers.
Exemplo 1
C:\PS>get-content -Path C:\Chapters\chapter1.txt Descrição ----------- Esse comando exibe o conteúdo do arquivo Chapter1.txt no console. Ele usa o parâmetro Path para especificar o nome do item. Na verdade, Get-Content transmite o conteúdo pelo pipeline, mas como não há outros elementos de pipeline, o conteúdo é formatado e exibido no console.
Exemplo 2
C:\PS>get-content c:\Logs\Log060912.txt -totalcount 50 | set-content sample.txt Descrição ----------- Esse comando obtém as primeiras 50 linhas do arquivo Log060912.txt e as armazena no arquivo sample.txt. O comando usa o cmdlet Get-Content para obter o texto do arquivo. O nome do parâmetro Path, que é opcional, foi omitido. O parâmetro TotalCount limita a recuperação às primeiras 50 linhas. O operador de pipeline (|) envia o resultado Set-Content, que o inclui no arquivo sample.txt.
Exemplo 3
C:\PS>(get-content cmdlets.txt -totalcount 5)[-1] Descrição ----------- Esse comando obtém a quinta linha do arquivo de texto Cmdlets.txt. Ele usa o parâmetro TotalCount para obter as cinco primeiras linhas e usa notação matricial para obter a última linha (indicada por "-1") do conjunto resultante.
See Also