Set-Content

Sintaxe

Path (Predefinição)

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

LiteralPath

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

Description

Exemplos

Exemplo 1: Substituir o conteúdo de vários arquivos em um diretório

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

Exemplo 2: Criar um novo arquivo e escrever conteúdo

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

1/30/2019 09:55:08

Exemplo 3: Substituir texto num ficheiro

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.

Exemplo 4: Usar filtros com Set-Content

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

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Credential

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.

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

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 FileSystem adiciona ao Set-Content. Este parâmetro funciona apenas em unidades de disco do sistema de arquivos.

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

Força o cmdlet a definir o conteúdo de um arquivo, mesmo que o arquivo seja somente leitura. A implementação varia de fornecedor para fornecedor. Para obter mais informações, consulte about_Providers. O parâmetro Force não substitui as 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

-NoNewline

As representações de cadeia de caracteres dos objetos de entrada são concatenadas para formar a saída. Nenhum espaço ou novas linhas são inseridos entre as cadeias de caracteres de saída. Nenhuma nova linha é adicionada após a última cadeia de caracteres de saída.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PassThru

Retorna um objeto que representa o conteúdo. Por padrão, esse cmdlet não gera nenhuma saída.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Path

Especifica o caminho do item que recebe o conteúdo. Caracteres coringa são permitidos.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Stream

Especifica um fluxo de dados alternativo para o conteúdo. Se o fluxo não existir, este cmdlet o cria. Não há suporte para caracteres curinga.

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

Você pode usar o cmdlet Set-Content para alterar o conteúdo do Zone.Identifier fluxo de dados alternativo. No entanto, não recomendamos isso como uma forma de eliminar as verificações de segurança que bloqueiam arquivos baixados da Internet. Se você verificar se um arquivo baixado é seguro, use o cmdlet Unblock-File.

Esse parâmetro foi introduzido no PowerShell 3.0.

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

-Value

Especifica o novo conteúdo do item.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

Object

Saídas

None or System.String

Notas

Ligações Relacionadas

• sobre_Aliases
• about_Automatic_Variables.md
• sobre_Fornecedores
• sobre_Transações
• Adicionar Conteúdo
• Limpar Conteúdo
• Get-ChildItem
• Get-Content (Obter Conteúdo)
• ForEach-Object
• Novo Item