Add-Content

Синтаксис

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>]

Описание

Командлет Add-Content добавляет содержимое к указанному элементу или файлу. Содержимое можно передать из конвейера или указать с помощью параметра Value .

Если вам нужно создать файлы или каталоги для следующих примеров, см . раздел "Новый элемент".

Примеры

Пример 1. Добавление строки ко всем текстовым файлам с исключением

Этот пример добавляет значение в текстовые файлы в текущем каталоге, но исключает файлы на основе их имени.

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

Параметр Path указывает все .txt файлы в текущем каталоге, но параметр Exclude игнорирует имена файлов, которые соответствуют указанному шаблону. Параметр Value указывает текстовую строку, записанную в файлы.

Используйте get-Content для отображения содержимого этих файлов.

Пример 2. Добавление даты в конец указанных файлов

В этом примере добавляется дата к файлам в текущем каталоге и отображается дата в консоли 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

Командлет Add-Content создает два новых файла в текущем каталоге. Параметр Value содержит выходные данные командлета Get-Date . Параметр PassThru выводит добавленное содержимое в конвейер. Так как для получения выходных данных нет другого командлета, он отображается в консоли PowerShell. Командлет Get-Content отображает обновленный файл. DateTimeFile1.log

Пример 3. Добавление содержимого указанного файла в другой файл

Этот пример получает содержимое из файла и сохраняет содержимое в переменной. Переменная используется для добавления содержимого в другой файл.

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

• Командлет Get-Content получает содержимое и сохраняет содержимое CopyFromFile.txt в переменной $From .
• Командлет Add-Content обновляет CopyToFile.txt файл с помощью содержимого переменной $From .
• Командлет Get-Content отображает CopyToFile.txt.

Пример 4. Добавление содержимого указанного файла в другой файл с помощью конвейера

Этот пример получает содержимое из файла и передает его командлету Add-Content .

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

Командлет Get-Content получает содержимое CopyFromFile.txt. Результаты передаются командлету Add-Content , который обновляет CopyToFile.txt. Отображается CopyToFile.txtпоследний Get-Content командлет.

Пример 5. Создание файла и копирование содержимого

В этом примере создается новый файл и копируется содержимое существующего файла в новый файл.

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

• Командлет Add-Content использует параметры Path и Value для создания нового файла в текущем каталоге.
• Командлет Get-Content получает содержимое существующего файла CopyFromFile.txt и передает его параметру Value . Круглые скобки вокруг командлета Get-Content гарантируют, что команда завершится до Add-Content начала команды.
• Командлет Get-Content отображает содержимое нового файла. NewFile.txt

Пример 6. Добавление содержимого в файл только для чтения

Эта команда добавляет значение в файл, даже если атрибут файла IsReadOnly имеет значение True. Действия по созданию файла, доступного только для чтения, включаются в пример.

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

• Командлет New-Item использует параметры Path и ItemType для создания файла IsReadOnlyTextFile.txt в текущем каталоге.
• Командлет Set-ItemProperty использует параметры Name и Value для изменения свойства IsReadOnly файла на True.
• Командлет Get-ChildItem показывает, что файл пуст (0) и имеет атрибут только для чтения (r).
• Командлет Add-Content использует параметр Path для указания файла. Параметр Value содержит текстовую строку для добавления в файл. Параметр Force записывает текст в файл только для чтения.
• Командлет Get-Content использует параметр Path для отображения содержимого файла.

Чтобы удалить атрибут только для чтения, используйте Set-ItemProperty команду со значением Falseпараметра Value.

Пример 7. Использование фильтров с контентом надстройки

Для командлета Add-Content можно указать фильтр. При использовании фильтров для квалификации параметра Path необходимо включить конечную звездочку (*), чтобы указать содержимое пути.

Следующая команда добавляет слово "Готово" содержимое всех *.txt файлов в каталоге C:\Temp .

Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"

Параметры

-AsByteStream

-Confirm

-Credential

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-NoNewline

-PassThru

-Path

-Stream

-Value

-WhatIf

Входные данные

Object

Можно передать значения Add-Contentв .

PSCredential

Вы можете передать учетные Add-Contentданные в .

Выходные данные

None

По умолчанию этот командлет не возвращает выходные данные.

String

При использовании параметра PassThru этот командлет возвращает объект System.String , представляющий содержимое.

Примечания

PowerShell включает следующие псевдонимы для Add-Content:

• Windows:

  • ac

• При отправке объекта в объект Add-Contentобъект преобразуется в строку перед добавлением в элемент. Формат строки определяется типом объекта, но может отличаться от используемого по умолчанию формата отображения объекта. Для управления форматом строки используйте параметры форматирования отправляющего командлета.

• Командлет Add-Content предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлет Get-PSProvider. Дополнительные сведения см. в about_Providers.

Связанные ссылки

• about_Aliases
• about_Providers
• Clear-Content
• Get-Content
• Get-Item
• New-Item
• Set-Content