Add-Content
Adiciona conteúdo aos itens especificados, como adicionar palavras a um arquivo.
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>]
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>]
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.
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 que é gravada nos arquivos.
Use Get-Content para exibir o conteúdo desses arquivos.
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 AM
O Add-Content
cmdlet cria dois novos arquivos no diretório atual. O parâmetro Value contém a Get-Date
saída do cmdlet. O parâmetro PassThru produz o conteúdo adicionado ao pipeline. Como não há outro cmdlet para receber a saída, ela é exibida no console do PowerShell. O Get-Content
cmdlet exibe o arquivo atualizado, DateTimeFile1.log
.
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 eCopyFromFile.txt
armazena o$From
conteúdo na variável. - O
Add-Content
cmdlet atualiza oCopyToFile.txt
arquivo usando o conteúdo da$From
variável. - O
Get-Content
cmdlet exibe CopyToFile.txt.
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.txt
O Get-Content
cmdlet obtém o conteúdo do 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
o .
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-Content
cmdlet usa os parâmetros Path e Value para criar um novo arquivo no diretório atual. - O
Get-Content
cmdlet obtém o conteúdo de um arquivoCopyFromFile.txt
existente e o passa para o parâmetro Value . Os parênteses ao redor doGet-Content
cmdlet garantem que o comando seja concluído antes doAdd-Content
início do comando. - O
Get-Content
cmdlet exibe o conteúdo do novo arquivo,NewFile.txt
.
Este 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-Item
cmdlet usa os parâmetros Path e ItemType para criar o arquivoIsReadOnlyTextFile.txt
no diretório atual. - O
Set-ItemProperty
cmdlet usa os parâmetros Name e Value 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
Add-Content
cmdlet 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-Content
cmdlet 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
.
Solicita a 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 |
Nota
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 |
Especifica o tipo de codificação para o arquivo de destino. O valor predefinido é Default
.
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
O mesmo que Unicode.Unicode
Usa UTF-16 com a ordem de bytes little-endian.Unknown
O 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 Add-Content
cmdlet. Este parâmetro funciona apenas em unidades do sistema de arquivos.
Type: | FileSystemCmdletProviderEncoding |
Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32 |
Position: | Named |
Default value: | Default |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 , onde C:\Windows\*
o caractere curinga especifica o C:\Windows
conteúdo do diretório.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Especifica um filtro para qualificar o parâmetro Path . O provedor FileSystem é o único provedor PowerShell instalado que oferece suporte ao uso de filtros. Você pode encontrar a sintaxe para a linguagem 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 |
Substitui o atributo somente leitura, permitindo que você adicione 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 |
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 só é efetivo quando o comando inclui o conteúdo de um item, como , onde C:\Windows\*
o caractere curinga especifica o C:\Windows
conteúdo do diretório.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como 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 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Indica que esse cmdlet não adiciona um novo retorno de linha ou 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 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
Especifica o caminho para os itens que recebem o 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 |
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 FileSystem adiciona ao Add-Content
. Este parâmetro funciona apenas em unidades do 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 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 Unblock-File
cmdlet.
Esse parâmetro foi introduzido no PowerShell 3.0.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Especifica o conteúdo a ser adicionado. Digite uma cadeia de caracteres entre aspas, como Estes 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 |
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Você pode canalizar valores para Add-Content
.
Você pode canalizar credenciais para Add-Content
.
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.
O Windows PowerShell inclui os seguintes aliases para Add-Content
:
ac
Quando você canaliza um objeto para
Add-Content
o , o objeto é convertido em uma cadeia de caracteres antes de ser adicionado ao item. O tipo de objeto determina o formato da 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-Content
cmdlet 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.
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: