Add-Content
Adiciona conteúdo aos itens especificados, como adicionar palavras a um arquivo.
Sintaxe
Path (Default)
Add-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
Add-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
O cmdlet Add-Content acrescenta conteúdo a um item ou arquivo especificado. Você pode especificar o conteúdo digitando o conteúdo no comando ou especificando um objeto que contenha o conteúdo.
Se você precisar criar arquivos ou diretórios para os exemplos a seguir, consulte New-Item.
Exemplos
Exemplo 1: Adicionar uma cadeia de caracteres a todos os arquivos de texto com uma exceção
Este exemplo acrescenta um valor aos arquivos de texto no diretório atual, mas exclui arquivos com base no nome do arquivo.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
O Add-Content cmdlet usa o parâmetro Path para especificar todos os arquivos .txt no diretório atual. O parâmetro Exclude ignora nomes de arquivo que correspondem ao padrão especificado. O parâmetro Value especifica a cadeia de caracteres de texto que é gravada nos arquivos.
Use o comando Get-Content para exibir o conteúdo desses arquivos.
Exemplo 2: adicionar uma data ao final dos arquivos especificados
Este exemplo acrescenta a data aos arquivos no diretório atual e exibe a data no console do PowerShell.
Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log
O Add-Content cmdlet usa os parâmetros Path e Value para criar dois novos arquivos no diretório atual. O parâmetro Value especifica o Get-Date cmdlet para obter a data e passa a data para Add-Content. O Add-Content cmdlet grava a data em cada arquivo. O parâmetro PassThru passa um objeto que representa o objeto de data. Como não há outro cmdlet para receber o objeto passado, ele é exibido no console do PowerShell. O Get-Content cmdlet exibe o arquivo atualizado, DateTimeFile1.log.
Exemplo 3: Adicionar o conteúdo de um arquivo especificado a outro arquivo
Este exemplo obtém o conteúdo de um arquivo e acrescenta esse conteúdo a outro arquivo.
Add-Content -Path .\CopyToFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\CopyToFile.txt
O Add-Content cmdlet usa o parâmetro Path para especificar o novo arquivo no diretório atual, CopyToFile.txt. O parâmetro Value usa o Get-Content cmdlet para obter o conteúdo do arquivo, CopyFromFile.txt. Os parênteses ao redor do cmdlet Get-Content garantem que o comando seja concluído antes do início do comando Add-Content. O parâmetro Value é passado para Add-Content. O Add-Content cmdlet acrescenta os dados ao arquivo CopyToFile.txt. O Get-Content cmdlet exibe o arquivo atualizado, CopyToFile.txt.
Exemplo 4: Usar uma variável para adicionar o conteúdo de um arquivo especificado a outro arquivo
Este exemplo obtém o conteúdo de um arquivo e armazena o conteúdo em uma variável. A variável é usada para acrescentar o conteúdo em outro arquivo.
$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
O Get-Content cmdlet obtém o conteúdo de CopyFromFile.txt e armazena o $From conteúdo na variável. O Add-Content cmdlet usa o parâmetro Path para especificar o arquivo CopyToFile.txt no diretório atual. O parâmetro Value usa a $From variável e passa o conteúdo para Add-Content. O Add-Content cmdlet atualiza o arquivo CopyToFile.txt. O cmdlet Get-Content exibe CopyToFile.txt.
Exemplo 5: Criar um novo arquivo e copiar conteúdo
Este exemplo cria um novo arquivo e copia o conteúdo de um arquivo existente no novo arquivo.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
O cmdlet Add-Content usa os parâmetros Path e Value para criar um novo arquivo no diretório atual. O parâmetro Value usa o Get-Content cmdlet para obter o conteúdo de um arquivo existente, CopyFromFile.txt. Os parênteses ao redor do cmdlet Get-Content garantem que o comando seja concluído antes do início do comando Add-Content. O parâmetro Value passa o conteúdo para Add-Content o qual atualiza o arquivo NewFile.txt. O Get-Content cmdlet exibe o conteúdo do novo arquivo, NewFile.txt.
Exemplo 6: Adicionar conteúdo a um arquivo somente leitura
Esse comando adiciona o valor ao arquivo mesmo se o atributo de arquivo IsReadOnly estiver definido como True. As etapas para criar um arquivo somente leitura são incluídas no exemplo.
New-Item -Path .\IsReadOnlyTextFile.txt -ItemType File
Set-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $True
Get-ChildItem -Path .\IsReadOnlyTextFile.txt
Add-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -Force
Get-Content -Path .\IsReadOnlyTextFile.txt
Mode LastWriteTime Length Name
---- ------------- ------ ----
-ar--- 1/28/2019 13:35 0 IsReadOnlyTextFile.txt
O New-Item cmdlet usa os parâmetros Path e ItemType para criar o IsReadOnlyTextFile.txt de arquivo no diretório atual. O cmdlet Set-ItemProperty usa os parâmetros Nome do e Valor do para alterar a propriedade IsReadOnly do arquivo para True. O Get-ChildItem cmdlet mostra que o arquivo está vazio (0) e tem o atributo somente leitura (r). O cmdlet Add-Content usa o parâmetro Path para especificar o arquivo. O parâmetro Value inclui a cadeia de caracteres de texto a ser acrescentada ao arquivo. O parâmetro Force grava o texto em um arquivo somente leitura. O cmdlet Get-Content usa o parâmetro Path para exibir o conteúdo do arquivo.
Para remover o atributo somente leitura, use o comando Set-ItemProperty com o parâmetro Value definido como False.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Credential
Especifica uma conta de usuário que tem 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 um gerado pelo cmdlet Get-Credential. Se você digitar um nome de usuário, será solicitado que você solicite uma senha.
Aviso
Esse parâmetro não tem suporte para nenhum provedor instalado com o PowerShell.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Encoding
Especifica o tipo de codificação para o arquivo de destino. O valor padrão é Default.
Os valores aceitáveis para esse parâmetro são os seguintes:
- ascii usa 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.
- padrão usa a codificação que corresponde à página de código ativo do sistema (geralmente ANSI).
- OEM usa a codificação que corresponde à página de código OEM atual do sistema.
- Corda O mesmo que Unicode.
- unicode usa UTF-16 com a ordem de byte little-endian.
desconhecido igual aoUnicode . - 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 cmdlet Add-Content. Esse parâmetro funciona apenas em unidades de arquivos do sistema.
Propriedades do parâmetro
| Tipo: | FileSystemCmdletProviderEncoding |
| Valor padrão: | Default |
| Valores aceitos: | ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32 |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Exclude
Omite os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como *.txt. Caracteres curinga são permitidos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Filter
Especifica um filtro no formato ou idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path. A sintaxe do filtro, incluindo o uso de caracteres curinga, depende do provedor. Os filtros são mais eficientes do que outros parâmetros porque o provedor aplica filtros quando os objetos são recuperados. Caso contrário, o PowerShell processará filtros depois que os objetos forem recuperados.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Substitui o atributo somente leitura, permitindo que você adicione conteúdo a um arquivo somente leitura. Por exemplo, o Force substituirá o atributo somente leitura ou criar diretórios para concluir um caminho de arquivo, mas não tentará alterar permissões de arquivo.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Include
Adiciona apenas os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como *.txt. Caracteres curinga são permitidos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LiteralPath
Especifica o caminho para os itens que recebem o conteúdo adicional. Diferente de Path, o valor de LiteralPath é usado exatamente como foi digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell que não deve interpretar nenhum caractere como uma sequência de escape.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
LiteralPath
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-NoNewline
Indica que esse cmdlet não adiciona uma nova linha ou retorno de carro ao conteúdo.
As representações de cadeia de caracteres dos objetos de entrada são concatenadas para formar a saída. Nenhum espaço ou nova linha é inserido entre as cadeias de caracteres de saída. Nenhuma nova linha é adicionada após a última cadeia de caracteres de saída.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PassThru
Retorna um objeto que representa o conteúdo adicionado. Por padrão, esse cmdlet não gera nenhuma saída.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Path
Especifica o caminho para os itens que recebem o conteúdo adicional. Caracteres curinga são permitidos. Se você especificar vários caminhos, use vírgulas para separar os caminhos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
Path
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Stream
Especifica um fluxo de dados alternativo para conteúdo. Se o fluxo não existir, esse cmdlet o criará. Não há suporte para caracteres curinga.
Stream é um parâmetro dinâmico que o provedor FileSystem adiciona a Add-Content. Esse parâmetro funciona apenas em unidades de arquivos do sistema.
Você pode usar o cmdlet Add-Content para alterar o conteúdo do Zone.Identifier fluxo de dados alternativo. No entanto, não recomendamos isso como uma forma de eliminar 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 do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UseTransaction
Inclui o comando na transação ativa. Esse parâmetro só é válido quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | usetx |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Value
Especifica o conteúdo a ser adicionado. Digite uma cadeia de caracteres entre aspas, como Esses dados são para uso interno apenasou especifique um objeto que contenha conteúdo, como o objeto DateTime gerado por Get-Date.
Você não pode especificar o conteúdo de um arquivo digitando seu caminho, porque o caminho é apenas uma cadeia de caracteres.
Você pode usar um comando Get-Content para obter o conteúdo e passá-lo para o parâmetro Value.
Propriedades do parâmetro
| Tipo: | Object[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
System.Object, System.Management.Automation.PSCredential
Você pode canalizar valores, caminhos ou credenciais para Set-Contento .
Saídas
None or System.String
Quando você usa o parâmetro PassThru, Add-Content gera um objeto System.String que representa o conteúdo. Caso contrário, esse cmdlet não gerará nenhuma saída.
Observações
Quando você canaliza um objeto para Add-Content, o objeto é convertido em uma cadeia de caracteres antes de ser adicionado ao item. O tipo de objeto determina o formato de cadeia de caracteres, mas o formato pode ser diferente da exibição padrão do objeto. Para controlar o formato de cadeia de caracteres, use os parâmetros de formatação do cmdlet de envio.
Você também pode consultar Add-Content por seu alias interno, ac. Para obter mais informações, consulte about_Aliases.
O cmdlet Add-Content foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.