Sintaxe

Add-Content <string> <Object> >] >] 

Add-Content <Object> -LiteralPath <string> >] >] 

Descrição

Add-Content cmdlet acrescenta conteúdo para um determinado item ou arquivo. Você pode especificar o conteúdo escrevendo o conteúdo no comando ou especificando um objeto que contém o conteúdo.

Se precisar de criar ficheiros ou directórios para os seguintes exemplos, veja o item novo.

exemplos

exemplo 1: Adicionar uma cadeia de caracteres a todos os ficheiros de texto com uma excepção

Este exemplo adiciona um valor aos ficheiros de texto na pasta actual, mas exclui os ficheiros com base no seu nome de ficheiro.

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

o parâmetro Path especifica todos os .txt ficheiros na pasta actual, mas o Excludeparameter ignora nomes de ficheiros que correspondem ao padrão especificado. O parâmetro valor Especifica a string text que é escrita para os arquivos.Exemplo 2: Adicionar uma data ao fim dos ficheiros indicados

este exemplo adiciona a data aos ficheiros na pasta actual e mostra a data na consola de resumo.

Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThruGet-Content -Path .\DateTimeFile1.logTuesday, May 14, 2019 8:24:27 AMTuesday, May 14, 2019 8:24:27 AM5/14/2019 8:24:27 AM

o Add-Content cmdlet cria dois novos ficheiros na pasta actual. O parâmetro do valor contém a saída do Get-Date cmdlet. O parâmetro PassThru fornece o conteúdo adicionado ao pipeline.Como não há outro cmdlet para receber a saída, ele é exibido na consola PowerShell.TheGet-Content cmdlet displays the updated file,DateTimeFile1.log.

exemplo 3: Adicionar o conteúdo de um arquivo especificado a outro arquivo

Este exemplo recebe o conteúdo de um arquivo e armazena o conteúdo em uma variável. A variável é usada para adicionar o conteúdo a outro ficheiro.

$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt

• Get-Content cmdlet obtém o conteúdo de CopyFromFile.txt e armazena o conteúdo de$From variável.
• The Add-Contentcmdlet updates the CopyToFile.txtfile using the contents of the $From variable.
• The Get-Content cmdlet displays CopyToFile.txt.

Exemplo 4: Adicionar o conteúdo de um determinado arquivo para outro arquivo usando o pipeline

Este exemplo obtém o conteúdo de um arquivo e canos para o Add-Content cmdlet.

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txt

Get-Content cmdlet obtém o conteúdo de CopyFromFile.txt. The results are piped to theAdd-Content cmdlet, which updates the CopyToFile.txt.The last Get-Content cmdlet displaysCopyToFile.txt.

exemplo 5: Criar um novo ficheiro e copiar o conteúdo

este exemplo cria um novo ficheiro e copia o conteúdo de um ficheiro existente para o novo ficheiro.

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt

• o Add-Content cmdlet usa os parâmetros de localização e valor para criar um novo ficheiro no directório actual.
• TheGet-Content cmdlet gets the contents of an existing file,CopyFromFile.txtand passes it to the Value parameter. Os parênteses em torno doGet-Content

Especifica que o conteúdo deve ser lido como um fluxo de bytes. Este parâmetro foi introduzido em powershell 6.0.

um aviso ocorre quando você usa o parâmetro AsByteStream com o parâmetro de codificação. TheAsByteStream parameter ignores any encoding and the output is returned as a stream of bytes.

Prompts you for confirmation before running the cmdlet.

Specifies the type of encoding for the target file. The default value is utf8NoBOM.

Encoding is a dynamic parameter that the FileSystem provider adds to the Add-Content cmdlet. Thisparameter works only in file system drives.

os valores aceitáveis para este parâmetro são os seguintes:

• ascii: usa a codificação para o conjunto de caracteres ASCII (7 bits).
• bigendianunicode: codes in UTF-16 format using the big-endian byte order.
• bigendianutf32: codes in UTF-32 format using the big-endian byte order.
• oem: usa a codificação padrão para MS-DOS e programas de consola.
• 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 Marca de Ordem de Byte (BOM)
• utf8NoBOM: Codifica no formato UTF-8 sem Marca de Ordem de Byte (BOM)
• utf32: Codifica em UTF-32 formato.

começando com PowerShell 6.2, The Encoding parameter also allows numeric IDs of registered codepages (like -Encoding 1251) or string names of registered code pages (like-Encoding "windows-1251"). Para mais informações, consulte a documentação. net forEncoding.codigo.

Specifies, as a string array, an item or items that this cmdlet excludes in the operation. The valueof this parameter qualifies the Path parameter. Indique um elemento ou padrão do caminho, tal como*.txt. São permitidos caracteres especiais. O parâmetro de exclusão só é eficaz quando o comando inclui o conteúdo de um item, como C:\Windows\*, onde a caracteres especiais especificam o conteúdo do diretório .

Especifica um filtro para qualificar o parâmetro de Caminho. O FileSystemprovider é o único fornecedor de PowerShell instalado que suporta o uso de filtros. Você pode encontrar a sintaxe para a linguagem de filtragem do sistema de arquivos em about_ wildcards.Os filtros são mais eficientes do que outros parâmetros, porque o Provedor os aplica quando o cmdlet anota os objetos ao invés de ter o filtro PowerShell os objetos depois que eles são recuperados.

Substitui o atributo só de leitura, permitindo que você adicione conteúdo para um ficheiro só de leitura. Por exemplo, o Force irá substituir o atributo apenas para leitura ou criar pastas para completar um caminho de arquivo, mas o butit não irá tentar alterar as permissões do arquivo.

Especifica, como uma matriz de seqüência de caracteres, um item ou itens que este cmdlet inclui na operação. O valor deste parâmetro qualifica O parâmetro Path. Indique um elemento ou padrão do caminho, como"*.txt". São permitidos caracteres especiais. O parâmetro de inclusão só é eficaz quando o comando inclui o conteúdo de um item, como C:\Windows\*, onde a caracteres especiais especificam o conteúdo do diretório .

Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como ele está escrito. Nenhum personagem é interpretado como wildcards. Se o caminho incluir caracteres de escape, enclausurá-los em aspas simples. Aspas simples dizem a PowerShell para não interpretar quaisquer caracteres como sequências de escape.

para mais informações, consulte about_quoting_ rules.

Indica que este cmdlet não adicionar uma nova linha ou retorno de carro para o conteúdo.

As representações de texto dos objetos de entrada são concatenadas para formar a saída. Não são inseridos espaços ornewlines entre as cadeias de saída. Não é adicionada nenhuma nova linha após o último texto de saída.

Retorna um objeto que representa o conteúdo adicionado. Por omissão, este cmdlet não gera nenhum rendimento.

Especifica o caminho para os itens que receber o conteúdo adicional.São permitidos caracteres especiais.Os caminhos devem ser caminhos para itens, não para recipientes.Por exemplo, você deve especificar um caminho para um ou mais arquivos, não um caminho para um diretório.Se indicar vários caminhos, use vírgulas para separar os caminhos.

especifica um fluxo de dados alternativo para o conteúdo. Se o fluxo não existir, este cmdlet createsit. Os caracteres especiais não são suportados.

Stream é um parâmetro dinâmico que o Provedor do sistema de arquivos adiciona a Add-Content. Thisparameter works only in file system drives.

Você pode usar o Add-Content cmdlet para alterar o conteúdo de qualquer alternatedata fluxo, como Zone.Identifier. No entanto, não recomendamos esta forma de eliminar os controlos de segurança que bloqueiam os ficheiros que são descarregados da Internet. Se verificar que um ficheiro transferido é Seguro, use oUnblock-File cmdlet.

This parameter was introduced in PowerShell 3.0.

Specifies the content to be added. Type a quoted string, such as This data is for internal useonly, or specify an object that contains content, such as the DateTime object that Get-Dategera.

Você não pode especificar o conteúdo de um arquivo escrevendo seu caminho, porque o caminho é apenas um texto.Você pode usar um comando Get-Content para obter o conteúdo e passá-lo para o parâmetro valor.

Shows what would happen if the cmdlet runs. The cmdlet is not run.