Adiciona conteúdo aos itens especificados, como a inclusão de palavras em um arquivo.
Sintaxe
Add-Content [-LiteralPath] <string[]> [-Value] <Object[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Add-Content [-Path] <string[]> [-Value] <Object[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Add-Content acrescenta conteúdo a um item ou arquivo especificado. Você pode especificar o conteúdo digitando-o no comando ou especificando um objeto que o contenha.
Parâmetros
-Credential <PSCredential>
Especifica uma conta de usuário com 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 aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Exclude <string[]>
Omite os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um elemento ou padrão do caminho, como "*.txt". Os caracteres curinga são permitidos.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Filter <string>
Especifica um filtro no formato ou no idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path. A sintaxe do filtro, incluindo o uso dos caracteres curinga, depende do provedor. Os filtros são mais eficientes do que outros parâmetros porque o provedor os aplica durante a recuperação dos objetos, em vez de fazer com que o Windows PowerShell os filtre depois de recuperados.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Force
Substitui o atributo somente leitura, permitindo adicionar conteúdo a um arquivo somente leitura.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Include <string[]>
Adiciona somente os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um elemento ou padrão do caminho, como "*.txt". Os caracteres curinga são permitidos.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-LiteralPath <string[]>
Especifica o caminho até os itens que recebem o conteúdo adicional. Ao contrário de Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-PassThru
Retorna um objeto que representa o conteúdo adicionado. Por padrão, este cmdlet não gera nenhuma saída.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Path <string[]>
Especifica o caminho até os itens que recebem o conteúdo adicional. Os caracteres curinga são permitidos. Caso você especifique vários caminhos, utilize vírgulas para separá-los.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Value <Object[]>
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 já tenha conteúdo, como o objeto DateTime gerado por Get-Date.
Não é possível especificar o conteúdo de um arquivo digitando seu caminho, já que o caminho é somente uma cadeia de caracteres, mas você pode usar o comando Get-Content para obter o conteúdo e passá-lo ao parâmetro Value.
|
Necessário? |
true |
|
Posição? |
2 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
System.Object É possível enviar os objetos a serem adicionados (o Value) para Add-Content. |
|
Saídas |
None ou System.String Quando você usa o parâmetro PassThru, Add-Content gerará um objeto System.String que representa o conteúdo. Caso contrário, esse cmdlet não gera nenhuma saída. |
Observações
Ao enviar por pipe 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 fazer referência a Add-Content usando seu alias interno, "ac". Para obter mais informações, consulte about_Aliases.
O cmdlet Add-Content foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PsProvider". Para obter mais informações, consulte about_Providers.
Exemplo 1
C:\PS>add-content -path *.txt -exclude help* -value "END" Descrição ----------- Esse comando adiciona "END" ao final de todos os arquivos de texto que estejam no diretório atual, exceto nos nomes de arquivo que comecem por "help".
Exemplo 2
C:\PS>add-content -Path file1.log, file2.log -Value (get-date) -passthru Descrição ----------- Esse comando adiciona a data ao final dos arquivos file1.log e file2.log e então a exibe na linha de comando. O comando usa o cmdlet Get-Date para obter a data, e o parâmetro Value para transmitir a data para Add-Content. O parâmetro PassThru transmite um objeto que representa o conteúdo adicionado pelo pipeline. Como não há outro cmdlet para receber o objeto passado, ele é exibido na linha de comando.
Exemplo 3
C:\PS>add-content -path monthly.txt -value (get-content c:\rec1\weekly.txt) Descrição ----------- Esse comando adiciona o conteúdo do arquivo weekly.txt ao final do arquivo monthly.txt. Ele usa o cmdlet Get-Content para obter o conteúdo do arquivo Weekly.txt, e o parâmetro Value para transmitir o conteúdo de weekly.txt para Add-Content. Os parênteses garantem que o comando Get-Content seja concluído antes do início do comando Add-Content. Você também pode copiar o conteúdo de Weekly.txt para uma variável, como $w, e usar o parâmetro Value para transmitir a variável a Add-Content. Nesse caso, o comando seria "add-content -path monthly.txt -value $w".
Exemplo 4
C:\PS>add-content -value (get-content test.log) -path C:\tests\test134\logs\test134.log Descrição ----------- Esse comando cria um novo arquivo e diretório e copia o conteúdo de um arquivo existente para o arquivo recém-criado. Esse comando usa o cmdlet Add-Content para adicionar o conteúdo. O valor do parâmetro Value é um comando Get-Content que obtém conteúdo de um arquivo existente, Test.log. O valor do parâmetro path é um caminho que não existe quando o comando é executado. Neste exemplo, somente os diretórios C:\Tests existem. O comando cria os demais diretórios e o arquivo Test134.log. O parâmetro Force não é obrigatório para este comando. Add-Content cria diretórios para completar um caminho mesmo sem o parâmetro Force.
See Also