Add-Content
Belirtilen öğelere dosyaya sözcük ekleme gibi içerik ekler.
Syntax
Path (Varsayılan)
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>]
Description
Cmdlet Add-Content, içeriği belirtilen bir öğeye veya dosyaya ekler. İçeriği komuta yazarak veya içeriği içeren bir nesne belirterek belirtebilirsiniz.
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.
Value 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-Contentcmdlet'iCopyFromFile.txtiçeriğini alır ve içeriği$Fromdeğişkeninde depolar. -
Add-Contentcmdlet'i,CopyToFile.txtdeğişkeninin içeriğini kullanarak$Fromdosyasını güncelleştirir. -
Get-Contentcmdlet'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-Contentcmdlet'i geçerli dizinde yeni bir dosya oluşturmak için Yol ve Değer parametrelerini kullanır. -
Get-Contentcmdlet var olan bir dosyanın içeriğini alır,CopyFromFile.txtve Value parametresine geçirir.Get-Contentcmdlet'in etrafındaki ayraçlar, komutunAdd-Contentkomutu başlamadan önce bitmesini sağlar. -
Get-Contentcmdlet'i yeni dosyanın içeriğiniNewFile.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-Itemcmdlet'i, geçerli dizinde dosya oluşturmak için Yol veIsReadOnlyTextFile.txtparametrelerini kullanır. -
Set-ItemPropertycmdlet'i, dosyanın IsReadOnly özelliğini True olarak değiştirmek için Name ve Value parametrelerini kullanır. -
Get-ChildItemcmdlet'i dosyanın boş (0) olduğunu ve salt okunur özniteliğine (r) sahip olduğunu gösterir. -
Add-Contentcmdlet'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-Contentcmdlet'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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Uyarı
Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı 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.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Encoding
Hedef dosya için kodlama türünü belirtir. Varsayılan değer şudur: 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. -
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: Küçük-öncelikli bayt sırası kullanılarak UTF-16 biçiminde kodlanır. -
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.
Uyarı
UTF-7* artık kullanılması önerilmez. PowerShell 7.1'den itibaren, utf7 parametresi için belirtirseniz bir uyarı yazılır.
Parametre özellikleri
| Tür: | Encoding |
| Default value: | UTF8NoBOM |
| Kabul edilen değerler: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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özdizimini about_Wildcards'de bulabilirsiniz. Filtreler diğer parametrelerden daha verimlidir, çünkü sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine cmdlet nesneleri aldığında bunları uygular.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Salt okunur özniteliği geçersiz kılarak salt okunur bir dosyaya içerik eklemenize olanak sağlar. Örneğin, Zorla salt okunur özniteliğini geçersiz kılar ancak dosya izinlerini değiştirmez.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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şaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.
Daha fazla bilgi için bkz. about_Quoting_Rules.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
LiteralPath
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-NoNewline
Bu cmdlet'in içeriğe yeni bir 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PassThru
Eklenen içeriği temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Path
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Stream
Uyarı
Bu Parametre yalnızca Windows'da kullanılabilir.
İçerik için alternatif bir veri akışı belirtir. 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, İnternet'ten indirilen dosyaları engelleyen güvenlik denetimlerini ortadan kaldırmanın bir yolu olarak bunu önermeyiz. İ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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Bir dosyanın içeriğini yolunu yazarak belirtemezsiniz, çünkü yol yalnızca bir dizedir.
İçeriği almak ve Get-Content parametresine geçirmek için bir komutu kullanabilirsiniz.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
System.Object, System.Management.Automation.PSCredential
Değerleri, yolları veya kimlik bilgilerini .Set-Content
Çıkışlar
None or System.String
PassThru parametresini kullandığınızda, Add-Content içeriği temsil eden bir System.String nesnesi oluşturur. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.
Notlar
- öğesine bir nesne
Add-Contentyönelttiğinizde, 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. - ayrıca
Add-Contentyerleşik diğer adı olanacile de başvurabilirsiniz. Daha fazla bilgi için bkz. about_Aliases. -
Add-Contentcmdlet'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çinGet-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.