Add-Content
Menambahkan konten ke item yang ditentukan, seperti menambahkan kata ke file.
Sintaks
Path (Default)
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>]
LiteralPath
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>]
Deskripsi
cmdlet Add-Content menambahkan konten ke item atau file tertentu. Konten dapat diteruskan dari alur atau ditentukan dengan menggunakan parameter Nilai .
Jika Anda perlu membuat file atau direktori untuk contoh berikut, lihat New-Item.
Contoh
Contoh 1: Menambahkan string ke semua file teks dengan pengecualian
Contoh ini menambahkan nilai ke file teks di direktori saat ini tetapi mengecualikan file berdasarkan nama filenya.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
Parameter Jalur menentukan semua file .txt di direktori saat ini, tetapi parameter Kecualikan mengabaikan nama file yang cocok dengan pola yang ditentukan. Parameter Nilai menentukan string teks yang akan ditulis ke dalam berkas.
Gunakan Get-Content untuk menampilkan konten file-file ini.
Contoh 2: Menambahkan tanggal ke akhir file yang ditentukan
Contoh ini menambahkan tanggal ke file di direktori saat ini dan menampilkan tanggal di konsol 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
Cmdlet Add-Content membuat dua file baru di direktori saat ini. Parameter Nilai berisi output dari cmdlet Get-Date. Parameter PassThru menghasilkan konten yang ditambahkan ke alur. Karena tidak ada cmdlet lain untuk menerima output, output tersebut ditampilkan di konsol PowerShell. Cmdlet Get-Content menampilkan file yang diperbarui, DateTimeFile1.log.
Contoh 3: Menambahkan konten file tertentu ke file lain
Contoh ini mendapatkan konten dari file dan menyimpan konten dalam variabel. Variabel digunakan untuk menambahkan konten ke file lain.
$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
- Cmdlet
Get-Contentmendapatkan kontenCopyFromFile.txtdan menyimpan konten dalam variabel$From. - Cmdlet
Add-Contentmemperbarui fileCopyToFile.txtmenggunakan konten variabel$From. - Cmdlet
Get-Contentmenampilkan CopyToFile.txt.
Contoh 4: Menambahkan konten file tertentu ke file lain menggunakan alur
Contoh ini mendapatkan konten dari file dan menyalurkannya ke cmdlet Add-Content.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txt
Cmdlet Get-Content mengambil isi dari CopyFromFile.txt. Hasilnya disalurkan ke cmdlet Add-Content, yang memperbarui CopyToFile.txt.
Cmdlet Get-Content terakhir menampilkan CopyToFile.txt.
Contoh 5: Membuat file baru dan menyalin konten
Contoh ini membuat file baru dan menyalin konten file yang ada ke dalam file baru.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
- Cmdlet
Add-Contentmenggunakan parameter Jalur dan Nilai untuk membuat file baru di direktori saat ini. - cmdlet
Get-Contentmendapatkan konten dari file yang ada,CopyFromFile.txtdan meneruskannya ke parameter Nilai . Tanda kurung di sekitar cmdletGet-Contentmemastikan bahwa perintah selesai sebelum perintahAdd-Contentdimulai. - Cmdlet
Get-Contentmenampilkan konten file baru,NewFile.txt.
Contoh 6: Menambahkan konten ke file baca-saja
Perintah ini menambahkan nilai ke file meskipun atribut file IsReadOnly diatur ke True. Langkah-langkah untuk membuat file baca-saja disertakan dalam contoh.
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
- Cmdlet
New-Itemmenggunakan Jalur dan ItemType parameter untuk membuat fileIsReadOnlyTextFile.txtdi direktori saat ini. - Cmdlet
Set-ItemPropertymenggunakan parameter Nama dan Nilai untuk mengubah properti IsReadOnly file menjadi True. - Cmdlet
Get-ChildItemmenunjukkan file kosong (0) dan memiliki atribut baca-saja (r). - Cmdlet
Add-Contentmenggunakan parameter Jalur untuk menentukan file. Parameter Nilai menyertakan string teks untuk ditambahkan ke file. Parameter Force menulis teks ke file baca-saja. - Cmdlet
Get-Contentmenggunakan parameter Jalur untuk menampilkan konten file.
Untuk menghapus atribut baca-saja, gunakan perintah Set-ItemProperty dengan parameter Nilai diatur ke False.
Contoh 7: Menggunakan Filter dengan Add-Content
Anda dapat menentukan filter ke cmdlet Add-Content. Saat menggunakan filter untuk memenuhi syarat parameter Jalur , Anda perlu menyertakan tanda bintang di belakang (*) untuk menunjukkan isi jalur tersebut.
Perintah berikut menambahkan kata "Selesai" konten semua file *.txt di direktori C:\Temp.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
Parameter
-AsByteStream
Menentukan bahwa konten harus dibaca sebagai aliran byte. Parameter ini diperkenalkan di PowerShell 6.0.
Peringatan terjadi saat Anda menggunakan parameter AsByteStream dengan parameter Enkoding. Parameter AsByteStream mengabaikan pengodean apa pun dan output dikembalikan sebagai aliran byte.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Credential
Nota
Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Encoding
Menentukan jenis pengodean untuk file target. Nilai defaultnya adalah utf8NoBOM.
Pengodean adalah parameter dinamis yang ditambahkan penyedia FileSystem ke cmdlet Add-Content. Parameter ini hanya berfungsi pada drive sistem berkas.
Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:
-
ascii: Menggunakan pengodean untuk set karakter ASCII (7-bit). -
ansi: Menggunakan pengodean untuk halaman kode ANSI budaya saat ini. Opsi ini ditambahkan di PowerShell 7.4. -
bigendianunicode: Mengenkripsi dalam format UTF-16 menggunakan urutan byte big-endian. -
bigendianutf32: Mengenkode dalam format UTF-32 menggunakan urutan byte big-endian. -
oem: Menggunakan pengkodean default untuk program MS-DOS dan program konsol. -
unicode: Mengode dalam format UTF-16 menggunakan urutan byte little-endian. -
utf7: Mengodekan dalam format UTF-7. -
utf8: Mengodekan dalam format UTF-8. -
utf8BOM: Mengodekan dalam format UTF-8 dengan Byte Order Mark (BOM) -
utf8NoBOM: Mengodekan dalam format UTF-8 tanpa Byte Order Mark (BOM) -
utf32: Mengodekan dalam format UTF-32.
Dimulai dengan PowerShell 6.2, parameter Pengodean
Dimulai dengan PowerShell 7.4, Anda dapat menggunakan nilai
Nota
UTF-7* tidak lagi disarankan untuk digunakan. Sejak PowerShell 7.1, sebuah peringatan akan ditulis jika Anda menentukan utf7 untuk parameter Pengodean .
Properti parameter
| Jenis: | Encoding |
| Nilai default: | UTF8NoBOM |
| Nilai yang diterima: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Exclude
Menentukan item atau item-item yang tidak akan disertakan dalam operasi oleh cmdlet ini, dalam bentuk array string. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti *.txt. Karakter pengganti diizinkan. Parameter Exclude hanya efektif ketika perintah menyertakan konten suatu item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Filter
Menentukan filter untuk mengkualifikasi parameter Jalur . Penyedia FileSystem adalah satu-satunya penyedia PowerShell yang diinstal yang mendukung penggunaan filter. Anda dapat menemukan sintaks untuk bahasa filter FileSystem dalam about_Wildcards. Filter lebih efisien dibandingkan parameter lainnya, karena penyedia menerapkannya ketika cmdlet mendapatkan objek, bukan PowerShell yang menyaring objek setelah mereka diambil.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Force
Mengambil alih atribut baca-saja, memungkinkan Anda menambahkan konten ke file baca-saja. Misalnya, Force mengambil alih atribut baca-saja tetapi tidak mengubah izin file.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Include
Menentukan item atau beberapa item dalam bentuk array string yang disertakan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti "*.txt". Karakter pengganti diizinkan. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-LiteralPath
Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai wildcard. Jika jalur menyertakan karakter escape, bungkus jalur tersebut dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Untuk informasi lebih lanjut, lihat about_Quoting_Rules.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | PSPath, LP |
Kumpulan parameter
LiteralPath
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-NoNewline
Menunjukkan bahwa cmdlet ini tidak menambahkan baris baru atau pengembalian baris ke konten.
Representasi string dari objek input digabungkan untuk membentuk output. Tidak ada spasi atau baris baru yang dimasukkan di antara string output. Tidak ada baris baru yang ditambahkan setelah string output terakhir.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-PassThru
Mengembalikan objek yang mewakili konten yang ditambahkan. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Menentukan jalur ke item yang menerima konten tambahan. Karakter pengganti diizinkan. Jalur harus berupa jalur menuju item, bukan menuju kontainer. Misalnya, Anda harus menentukan jalur ke satu atau beberapa file, bukan jalur ke direktori. Jika Anda menentukan beberapa jalur, gunakan koma untuk memisahkan jalur.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
Path
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Stream
Nota
Parameter ini hanya tersedia di Windows.
Menentukan aliran data alternatif untuk konten. Jika stream tidak ada, cmdlet ini akan membuatnya. Karakter pengganti tidak didukung.
Stream adalah parameter dinamis yang ditambahkan penyedia FileSystem ke Add-Content. Parameter ini hanya berfungsi pada drive sistem berkas.
Anda dapat menggunakan cmdlet Add-Content untuk mengubah konten aliran data alternatif apa pun, seperti Zone.Identifier. Namun, kami tidak merekomendasikan ini sebagai cara untuk menghilangkan pemeriksaan keamanan yang memblokir file yang diunduh dari Internet. Jika Anda memverifikasi bahwa file yang diunduh aman, gunakan cmdlet Unblock-File.
Parameter ini diperkenalkan di PowerShell 3.0. Pada PowerShell 7.2, Add-Content dapat menargetkan aliran data alternatif pada file dan direktori.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Value
Menentukan isi yang akan ditambahkan. Ketik string yang dikutip, seperti Data ini hanya untuk penggunaan internal, atau tentukan objek yang berisi konten, seperti objek DateTime yang Get-Date hasilkan.
Anda tidak dapat menentukan konten file dengan mengetik jalurnya, karena jalurnya hanyalah string.
Anda dapat menggunakan perintah Get-Content untuk mendapatkan konten dan meneruskannya ke parameter Nilai.
Properti parameter
| Jenis: | Object[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 1 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
Object
Anda dapat menyalurkan nilai ke Add-Content.
PSCredential
Anda dapat menyalurkan kredensial ke Add-Content.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
String
Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek System.String yang mewakili konten.
Catatan
PowerShell menyertakan alias berikut untuk Add-Content:
Windows:
ac
Saat Anda menyalurkan objek ke
Add-Content, objek dikonversi ke string sebelum ditambahkan ke item. Jenis objek menentukan format string, tetapi formatnya mungkin berbeda dari tampilan default objek. Untuk mengontrol format string, gunakan parameter pemformatan cmdlet pengiriman.Cmdlet
Add-Contentdirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia dalam sesi Anda, ketikGet-PSProvider. Untuk informasi selengkapnya, lihat tentang_Penyedia.
