Set-Content

Syntax

Set-Content
   [-Path] <string[]>
   [-Value] <Object[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-NoNewline]
   [-Encoding <Encoding>]
   [-AsByteStream]
   [-Stream <string>]
   [<CommonParameters>]

Set-Content
   [-Value] <Object[]>
   -LiteralPath <string[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-NoNewline]
   [-Encoding <Encoding>]
   [-AsByteStream]
   [-Stream <string>]
   [<CommonParameters>]

Set-Content
   [-Path] <string[]>
   [-Value] <Object[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-Content
   [-Value] <Object[]>
   -LiteralPath <string[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-Content é um cmdlet de processamento de cadeias que escreve novos conteúdos ou substitui o conteúdo num ficheiro. Set-Content substitui o conteúdo existente e difere do Add-Content cmdlet que acrescenta conteúdo a um ficheiro. Para enviar conteúdo para Set-Content pode utilizar o parâmetro Valor na linha de comandos ou enviar conteúdo através do pipeline.

Se precisar de criar ficheiros ou diretórios para os seguintes exemplos, veja New-Item (Novo Item).

Exemplos

Exemplo 1: Substituir o conteúdo de vários ficheiros num diretório

Este exemplo substitui o conteúdo de vários ficheiros no diretório atual.

Get-ChildItem -Path .\Test*.txt

Test1.txt
Test2.txt
Test3.txt

Set-Content -Path .\Test*.txt -Value 'Hello, World'
Get-Content -Path .\Test*.txt

Hello, World
Hello, World
Hello, World

O Get-ChildItem cmdlet utiliza o parâmetro Caminho para listar .txt ficheiros que começam Test* no diretório atual. O Set-Content cmdlet utiliza o parâmetro Caminho para especificar os Test*.txt ficheiros. O parâmetro Valor fornece a cadeia de texto Hello, Mundo, que substitui o conteúdo existente em cada ficheiro. O Get-Content cmdlet utiliza o parâmetro Caminho para especificar os Test*.txt ficheiros e apresenta o conteúdo de cada ficheiro na consola do PowerShell.

Exemplo 2: Create um novo ficheiro e escrever conteúdo

Este exemplo cria um novo ficheiro e escreve a data e hora atuais no ficheiro.

Set-Content -Path .\DateTime.txt -Value (Get-Date)
Get-Content -Path .\DateTime.txt

1/30/2019 09:55:08

Set-Content utiliza os parâmetros Caminho e Valor para criar um novo ficheiro com o nome DateTime.txt no diretório atual. O parâmetro Valor utiliza Get-Date para obter a data e hora atuais. Set-Content escreve o objeto DateTime no ficheiro como uma cadeia. O Get-Content cmdlet utiliza o parâmetro Caminho para apresentar o conteúdo do DateTime.txt na consola do PowerShell.

Exemplo 3: Substituir texto num ficheiro

Este comando substitui todas as instâncias do word num ficheiro existente.

Get-Content -Path .\Notice.txt

Warning
Replace Warning with a new word.
The word Warning was replaced.

(Get-Content -Path .\Notice.txt) |
    ForEach-Object {$_ -Replace 'Warning', 'Caution'} |
        Set-Content -Path .\Notice.txt
Get-Content -Path .\Notice.txt

Caution
Replace Caution with a new word.
The word Caution was replaced.

O Get-Content cmdlet utiliza o parâmetro Caminho para especificar o ficheiro Notice.txt no diretório atual. O Get-Content comando é moldado com parênteses para que o comando seja concluído antes de ser enviado para baixo do pipeline.

Os conteúdos do ficheiro Notice.txt são enviados pelo pipeline para o ForEach-Object cmdlet. ForEach-Object utiliza a variável $_ automática e substitui cada ocorrência de Avisopor Atenção. Os objetos são enviados pelo pipeline para o Set-Content cmdlet. Set-Content utiliza o parâmetro Caminho para especificar o ficheiro Notice.txt e escreve o conteúdo atualizado no ficheiro.

O último Get-Content cmdlet apresenta o conteúdo do ficheiro atualizado na consola do PowerShell.

Exemplo 4: Utilizar Filtros com Set-Content

Pode especificar um filtro para o Set-Content cmdlet. Ao utilizar filtros para qualificar o parâmetro Caminho , tem de incluir um asterisco à direita (*) para indicar o conteúdo do caminho.

O comando seguinte definiu o conteúdo de todos os *.txt ficheiros no C:\Temp diretório como Valor vazio.

Set-Content -Path C:\Temp\* -Filter *.txt -Value "Empty"

Parâmetros

-AsByteStream

-Confirm

-Credential

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-NoNewline

-PassThru

-Path

-Stream

-Value

-WhatIf

Entradas

Object

Pode encaminhar um objeto que contém o novo valor do item para este cmdlet.

Saídas

None

Por predefinição, este cmdlet não devolve nenhuma saída.

String

Quando utiliza o parâmetro PassThru , este cmdlet devolve uma cadeia que representa o conteúdo.

Notas

• Set-Content foi concebido para processamento de cadeias. Se encaminhar objetos que não sejam de cadeia para Set-Content, este converte o objeto numa cadeia antes de o escrever. Para escrever objetos em ficheiros, utilize Out-File.
• O Set-Content cmdlet foi concebido para funcionar com os dados expostos por qualquer fornecedor. Para listar os fornecedores disponíveis na sua sessão, escreva Get-PsProvider. Para obter mais informações, veja about_Providers.

Ligações Relacionadas

• about_Aliases
• about_Automatic_Variables.md
• about_Providers
• Add-Content
• Clear-Content
• Get-ChildItem
• Get-Content
• ForEach-Object
• New-Item