Aracılığıyla paylaş

Add-Content

  • Başvuru
Modül:
Microsoft.PowerShell.Management

Belirtilen öğelere dosyaya sözcük ekleme gibi içerik ekler.

Sözdizimi

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

Description

Cmdlet Add-Content, içeriği belirtilen bir öğeye veya dosyaya ekler. İçerik işlem hattından geçirilebilir veya Değer parametresi kullanılarak belirtilebilir.

Aşağıdaki örnekler için dosya veya dizin oluşturmanız gerekiyorsa bkz. New-Item.

Örnekler

Örnek 1: Özel durum içeren tüm metin dosyalarına dize ekleme

Bu örnek, geçerli dizindeki metin dosyalarına bir değer ekler, ancak dosyaları dosya adlarına göre dışlar.

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

Path parametresi geçerli dizindeki tüm .txt dosyalarını belirtir, ancak Exclude parametresi belirtilen desenle eşleşen dosya adlarını yoksayar. Değeri parametresi, dosyalara yazılan metin dizesini belirtir.

Bu dosyaların içeriğini görüntülemek için get-content kullanın.

Örnek 2: Belirtilen dosyaların sonuna tarih ekleme

Bu örnek, tarihi geçerli dizindeki dosyalara ekler ve tarihi PowerShell konsolunda görüntüler.

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 cmdlet'i geçerli dizinde iki yeni dosya oluşturur. Value parametresi, Get-Date cmdlet'in çıkışını içerir. PassThru parametresi, eklenen içerikleri işlem hattına aktarır. Çıkışı alacak başka bir cmdlet olmadığından, PowerShell konsolunda görüntülenir. Get-Content cmdlet'i, güncellenmiş dosya DateTimeFile1.log'i görüntüler.

Örnek 3: Belirtilen dosyanın içeriğini başka bir dosyaya ekleme

Bu örnek, bir dosyadaki içeriği alır ve içeriği bir değişkende depolar. değişkeni, içeriği başka bir dosyaya eklemek için kullanılır.

$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
  • Get-Content cmdlet'i CopyFromFile.txt içeriğini alır ve içeriği $From değişkeninde depolar.
  • Add-Content cmdlet'i, CopyToFile.txt değişkeninin içeriğini kullanarak $From dosyasını güncelleştirir.
  • Get-Content cmdlet'i CopyToFile.txt'i görüntüler.

Örnek 4: İşlem hattını kullanarak belirtilen dosyanın içeriğini başka bir dosyaya ekleme

Bu örnek bir dosyadan içeriği alır ve Add-Content cmdlet'ine aktarır.

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

Get-Content cmdlet'i CopyFromFile.txtiçeriğini alır. Sonuçlar, Add-Content cmdlet'ine yönlendirilir ve bu da CopyToFile.txtgünceller. Son cmdlet Get-Content, CopyToFile.txt'i görüntüler.

Örnek 5: Yeni dosya oluşturma ve içerik kopyalama

Bu örnek yeni bir dosya oluşturur ve var olan bir dosyanın içeriğini yeni dosyaya kopyalar.

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
  • Add-Content cmdlet'i geçerli dizinde yeni bir dosya oluşturmak için Yol ve Değer parametrelerini kullanır.
  • Get-Content cmdlet var olan bir dosyanın içeriğini alır, CopyFromFile.txt ve Value parametresine geçirir. Get-Content cmdlet'in etrafındaki ayraçlar, komutun Add-Content komutu başlamadan önce bitmesini sağlar.
  • Get-Content cmdlet'i yeni dosyanın içeriğini NewFile.txtgörüntüler.

Örnek 6: Salt okunur bir dosyaya içerik ekleme

Bu komut, IsReadOnly dosya özniteliği Trueolarak ayarlansa bile dosyaya bir değer ekler. Salt okunur dosya oluşturma adımları örnekte yer alır.

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 cmdlet'i, geçerli dizinde dosya oluşturmak için Yol ve IsReadOnlyTextFile.txt parametrelerini kullanır.
  • Set-ItemProperty cmdlet'i, dosyanın IsReadOnly özelliğini True olarak değiştirmek için Name ve Value parametrelerini kullanır.
  • Get-ChildItem cmdlet'i dosyanın boş (0) olduğunu ve salt okunur özniteliğine (r) sahip olduğunu gösterir.
  • Add-Content cmdlet'i dosyayı belirtmek için Path parametresini kullanır. Value parametresi, dosyaya eklenecek metin dizesini içerir. Force parametresi metni salt okunur dosyaya yazar.
  • Get-Content cmdlet'i, dosyanın içeriğini görüntülemek için Path parametresini kullanır.

Salt okunur özniteliği kaldırmak için Set-ItemProperty parametresi olarak ayarlanmış False komutunu kullanın.

Örnek 7: filtreleri Add-Content ile kullanma

Add-Content cmdlet'ine bir filtre belirtebilirsiniz. Yolu parametresini niteleme amacıyla filtreler kullanırken, yolun içeriğini göstermek için sondaki yıldız işareti (*) eklemeniz gerekir.

Aşağıdaki komut, *.txt dizinindeki tüm C:\Temp dosyalarının içeriğini "Bitti" sözcüğünü ekler.

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

Parametreler

-AsByteStream

İçeriğin bayt akışı olarak okunması gerektiğini belirtir. Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

Kodlama parametresiyle AsByteStream parametresini kullandığınızda bir uyarı oluşur. AsByteStream parametresi tüm kodlamaları yoksayar ve çıkış bayt akışı olarak döndürülür.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Credential

Not

Bu parametre, PowerShell ile yüklenen sağlayıcılar tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Commandkullanın.

Tür:PSCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Encoding

Hedef dosya için kodlama türünü belirtir. Varsayılan değer utf8NoBOM.

Kodlama, FileSystem sağlayıcısının Add-Content cmdlet'ine eklediği dinamik bir parametredir. Bu parametre yalnızca dosya sistemi sürücülerinde çalışır.

Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:

  • ascii: ASCII (7 bit) karakter kümesi için kodlamayı kullanır.
  • ansi: Geçerli kültürün ANSI kod sayfasının kodlamasını kullanır. Bu seçenek PowerShell 7.4'e eklendi.
  • bigendianunicode: Büyük endian bayt sırasını kullanarak UTF-16 biçiminde kodlar.
  • bigendianutf32: Büyük endian bayt sırasını kullanarak UTF-32 biçiminde kodlar.
  • oem: MS-DOS ve konsol programları için varsayılan kodlamayı kullanır.
  • unicode: Little-endian bayt sırasını kullanarak UTF-16 biçiminde kodlar.
  • utf7: UTF-7 biçiminde kodlar.
  • utf8: UTF-8 biçiminde kodlar.
  • utf8BOM: Bayt Sırası İşareti (BOM) ile UTF-8 biçiminde kodlar
  • utf8NoBOM: Bayt Sırası İşareti (BOM) olmadan UTF-8 biçiminde kodlar
  • utf32: UTF-32 biçiminde kodlar.

PowerShell 6.2'den başlayarak, Kodlama parametresi, kayıtlı kod sayfalarının sayısal kimliklerine (-Encoding 1251gibi) veya kayıtlı kod sayfalarının dize adlarına (-Encoding "windows-1251"gibi) de izin verir. Daha fazla bilgi için Encoding.CodePageiçin .NET belgelerine bakın.

PowerShell 7.4'den başlayarak, Ansi parametresinin değerini kullanarak geçerli kültürün ANSI kod sayfasının sayısal kimliğini el ile belirtmek zorunda kalmadan geçirebilirsiniz.

Not

UTF-7* artık kullanılması önerilmez. PowerShell 7.1'den itibaren, utf7 parametresi için belirtirseniz bir uyarı yazılır.

Tür:Encoding
Kabul edilen değerler:ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:Named
Default value:UTF8NoBOM
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Exclude

Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler. *.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter C:\Windows dizininin içeriğini belirtir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-Filter

Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcardsbulabilirsiniz. Filtreler, PowerShell'in nesneleri aldıktan sonra filtreleme yapması yerine, sağlayıcı nesneleri alırken bunları uyguladığı için diğer parametrelerden daha verimlidir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-Force

Salt okunur özniteliği geçersiz kılarak salt okunur bir dosyaya içerik eklemenize olanak sağlar. Örneğin, Zorlama salt okunur özelliği geçersiz kılar ancak dosya izinlerini değiştirmez.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Include

Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler. "*.txt"gibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde ve joker karakteri C:\Windows dizininin içeriğini belirttiğinde etkilidir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-LiteralPath

Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak içinde yazın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Daha fazla bilgi için bkz. about_Quoting_Rules.

Tür:String[]
Diğer adlar:PSPath, LP
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-NoNewline

Bu cmdlet'in içeriğe yeni satır veya satır başı eklemediğini gösterir.

Giriş nesnelerinin dize gösterimleri, çıkışı oluşturmak için birleştirilir. Çıkış dizeleri arasına boşluk veya yeni satır eklenmez. Son çıkış dizesinden sonra yeni satır eklenmez.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PassThru

Eklenen içeriği temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Path

Ek içeriği alan öğelerin yolunu belirtir. Joker karakterlere izin verilir. Yollar kapsayıcılara değil öğelere giden yollar olmalıdır. Örneğin, dizin yolu değil, bir veya daha fazla dosya için yol belirtmeniz gerekir. Birden çok yol belirtirseniz, yolları ayırmak için virgül kullanın.

Tür:String[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

-Stream

Not

Bu Parametre yalnızca Windows'da kullanılabilir.

İçerik için alternatif bir veri akışı belirtir. Eğer veri akışı yoksa, bu cmdlet onu oluşturur. Joker karakterler desteklenmez.

Stream, FileSystem sağlayıcısının Add-Contenteklediği dinamik bir parametredir. Bu parametre yalnızca dosya sistemi sürücülerinde çalışır.

Add-Contentgibi herhangi bir alternatif veri akışının içeriğini değiştirmek için Zone.Identifier cmdlet'ini kullanabilirsiniz. Ancak, bunu İnternet'ten indirilen dosyaları engelleyen güvenlik denetimlerini ortadan kaldırmanın bir yolu olarak önermiyoruz. İndirilen bir dosyanın güvenli olduğunu doğrularsanız Unblock-File cmdlet'ini kullanın.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur. PowerShell 7.2 itibarıyla Add-Content hem dosyalar hem de dizinler üzerinde alternatif veri akışlarını hedefleyebilir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Value

Eklenecek içeriği belirtir. Bu veriler yalnızcaiç kullanım içindir gibi tırnak içine alınmış bir dize yazın veya oluşturan Get-Date nesnesi gibi içerik içeren bir nesne belirtin.

Yol yalnızca bir dize olduğundan, dosyanın içeriğini yolunu yazarak belirtemezsiniz. İçeriği almak ve Get-Content parametresine geçirmek için bir komutu kullanabilirsiniz.

Tür:Object[]
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

Object

Değerleri Add-Content'a yönlendirebilirsiniz.

PSCredential

Kimlik bilgilerini Add-Contentyönlendirebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

String

PassThru parametresini kullandığınızda, bu cmdlet içeriği temsil eden bir System.String nesnesi döndürür.

Notlar

PowerShell, Add-Contentiçin aşağıdaki diğer adları içerir:

  • Windows:

    • ac

  • Bir nesneyi Add-Content'ye yönelttiğinde, nesne öğeye eklenmeden önce bir dizeye dönüştürülür. Nesne türü dize biçimini belirler, ancak biçim nesnenin varsayılan görüntüsünden farklı olabilir. Dize biçimini denetlemek için, gönderen cmdlet'in biçimlendirme parametrelerini kullanın.

  • Add-Content cmdlet'i herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.