Add-Content
Adiciona conteúdo aos itens especificados, como a adição de palavras a um arquivo.
Syntax
Add-Content
[-Path] <string[]>
[-Value] <Object[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-NoNewline]
[-Encoding <Encoding>]
[-AsByteStream]
[-Stream <string>]
[<CommonParameters>]Add-Content
[-Value] <Object[]>
-LiteralPath <string[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-NoNewline]
[-Encoding <Encoding>]
[-AsByteStream]
[-Stream <string>]
[<CommonParameters>]Description
O Add-Content cmdlet acrescenta conteúdo a um item ou arquivo especificado. O conteúdo pode ser passado do pipeline ou especificado usando o parâmetro Value .
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 a arquivos de texto no diretório atual, mas exclui arquivos com base em seu nome de arquivo.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'O parâmetro Path especifica todos os .txt arquivos no diretório atual, mas 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 gravada nos arquivos.
Use 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
Tuesday, May 14, 2019 8:24:27 AM
Tuesday, May 14, 2019 8:24:27 AM
5/14/2019 8:24:27 AMO Add-Content cmdlet cria dois novos arquivos no diretório atual. O parâmetro Value contém a saída do Get-Date cmdlet. O parâmetro PassThru gera o conteúdo adicionado ao pipeline. Como não há outro cmdlet para receber a saída, 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 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-Contentcmdlet obtém o conteúdo e armazena o$Fromconteúdo naCopyFromFile.txtvariável. - O
Add-Contentcmdlet atualiza oCopyToFile.txtarquivo usando o conteúdo da$Fromvariável. - O
Get-Contentcmdlet exibe CopyToFile.txt.
Exemplo 4: Adicionar o conteúdo de um arquivo especificado a outro arquivo usando o pipeline
Este exemplo obtém o conteúdo de um arquivo e o canaliza para o Add-Content cmdlet.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txtO Get-Content cmdlet obtém o conteúdo de CopyFromFile.txt. Os resultados são canalizados para o Add-Content cmdlet, que atualiza o CopyToFile.txt.
O último Get-Content cmdlet 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 para o novo arquivo.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt- O
Add-Contentcmdlet usa os parâmetros Path e Value para criar um novo arquivo no diretório atual. - O
Get-Contentcmdlet obtém o conteúdo de um arquivoCopyFromFile.txtexistente e o passa para o parâmetro Value . Os parênteses ao redor doGet-Contentcmdlet garantem que o comando seja concluído antes do início doAdd-Contentcomando. - O
Get-Contentcmdlet exibe o conteúdo do novo arquivo,NewFile.txt.
Exemplo 6: Adicionar conteúdo a um arquivo somente leitura
Esse comando adiciona um valor ao arquivo mesmo se o atributo de arquivo IsReadOnly estiver definido como True. As etapas para criar um arquivo somente leitura estã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-Itemcmdlet usa os parâmetros Path e ItemType para criar o arquivoIsReadOnlyTextFile.txtno diretório atual. - O
Set-ItemPropertycmdlet usa os parâmetros Name e Value para alterar a propriedade IsReadOnly do arquivo para True. - O
Get-ChildItemcmdlet mostra que o arquivo está vazio (0) e tem o atributo somente leitura (r). - O
Add-Contentcmdlet usa o parâmetro Path para especificar o arquivo. O parâmetro Value inclui a cadeia de caracteres de texto a ser anexada ao arquivo. O parâmetro Force grava o texto no arquivo somente leitura. - O
Get-Contentcmdlet usa o parâmetro Path para exibir o conteúdo do arquivo.
Para remover o atributo somente leitura, use o Set-ItemProperty comando com o parâmetro Value definido como False.
Exemplo 7: Usar filtros com conteúdo adicional
Você pode especificar um filtro para o Add-Content cmdlet. Ao usar filtros para qualificar o parâmetro Path , você precisa incluir um asterisco à direita (*) para indicar o conteúdo do caminho.
O comando a seguir adiciona a palavra "Concluído" ao conteúdo de todos os *.txt arquivos no C:\Temp diretório.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"Parâmetros
-AsByteStream
Especifica que o conteúdo deve ser lido como um fluxo de bytes. Esse parâmetro foi introduzido no PowerShell 6.0.
Um aviso ocorre quando você usa o parâmetro AsByteStream com o parâmetro Encoding . O parâmetro AsByteStream ignora qualquer codificação e a saída é retornada como um fluxo de bytes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Observação
Esse parâmetro não é suportado por nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
Especifica o tipo de codificação para o arquivo de destino. O valor padrão é utf8NoBOM.
A codificação é um parâmetro dinâmico que o provedor FileSystem adiciona ao Add-Content cmdlet. Esse parâmetro funciona somente em unidades de sistema de arquivos.
Os valores aceitáveis para esse parâmetro são os seguintes:
ascii: Usa a codificação para o conjunto de caracteres ASCII (7 bits).bigendianunicode: Codifica no formato UTF-16 usando a ordem de bytes big-endian.bigendianutf32: Codifica no formato UTF-32 usando a ordem de bytes big-endian.oem: Usa a codificação padrão para MS-DOS e programas de console.unicode: Codifica no formato UTF-16 usando a ordem de bytes little-endian.utf7: Codifica no formato UTF-7.utf8: Codifica no formato UTF-8.utf8BOM: Codifica no formato UTF-8 com Byte Order Mark (BOM)utf8NoBOM: Codifica no formato UTF-8 sem Byte Order Mark (BOM)utf32: Codifica no formato UTF-32.
A partir do PowerShell 6.2, o parâmetro Encoding também permite IDs numéricos de páginas de código registradas (como -Encoding 1251) ou nomes de cadeia de caracteres de páginas de código registradas (como -Encoding "windows-1251"). Para obter mais informações, consulte a documentação do .NET para Encoding.CodePage.
Observação
UTF-7* não é mais recomendado para uso. A partir do PowerShell 7.1, um aviso será escrito se você especificar utf7 para o parâmetro Encoding .
| Type: | Encoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | Named |
| Default value: | UTF8NoBOM |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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 curinga são permitidos. O parâmetro Exclude é efetivo somente quando o comando inclui o conteúdo de um item, como , em C:\Windows\*que o caractere curinga C:\Windows especifica o conteúdo do diretório.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-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. Você pode encontrar a sintaxe do idioma de filtro FileSystem 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
Substitui o atributo somente leitura, permitindo adicionar conteúdo a um arquivo somente leitura. Por exemplo, Force substitui o atributo somente leitura, mas não altera as permissões de arquivo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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 curinga são permitidos. O parâmetro Include é efetivo somente quando o comando inclui o conteúdo de um item, como , onde C:\Windows\*o caractere curinga C:\Windows especifica o conteúdo do diretório.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-LiteralPath
Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.
Para obter mais informações, consulte about_Quoting_Rules.
| Type: | String[] |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Retorna um objeto que representa o conteúdo adicionado. Por padrão, esse cmdlet não gera nenhuma saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifica o caminho para os itens que recebem conteúdo adicional. Caracteres curinga 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. Se você especificar vários caminhos, use vírgulas para separá-los.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Stream
Observação
Este parâmetro só está disponível no Windows.
Especifica um fluxo de dados alternativo para o 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 ao Add-Content. Esse parâmetro funciona somente em unidades de sistema de arquivos.
Você pode usar o Add-Content cmdlet para alterar o conteúdo de qualquer fluxo de dados alternativo, como Zone.Identifier. No entanto, não recomendamos isso como uma maneira de eliminar as verificações de segurança que bloqueiam arquivos baixados da Internet. Se você verificar se um arquivo baixado é seguro, use o Unblock-File cmdlet.
Esse parâmetro foi introduzido no PowerShell 3.0. A partir do PowerShell 7.2, Add-Content pode direcionar fluxos de dados alternativos em arquivos e diretórios.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Value
Especifica o conteúdo a ser adicionado. Digite uma cadeia de caracteres entre aspas, como Esses dados são apenas para uso interno, ou especifique um objeto que contenha conteúdo, como o objeto DateTime que Get-Date gera.
Não é possível especificar o conteúdo de um arquivo digitando seu caminho, porque o caminho é apenas uma cadeia de caracteres.
Você pode usar um Get-Content comando para obter o conteúdo e passá-lo para o parâmetro Value .
| Type: | Object[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Você pode canalizar valores para Add-Content.
Você pode canalizar credenciais para Add-Contento .
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto System.String que representa o conteúdo.
Observações
O PowerShell inclui os seguintes aliases para Add-Content:
Windows:
ac
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 da cadeia de caracteres, use os parâmetros de formatação do cmdlet de envio.O
Add-Contentcmdlet foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digiteGet-PSProvider. Para obter mais informações, consulte about_Providers.
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de