Add-Content

Modül:

Microsoft.PowerShell.Management Module

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]
    [-UseTransaction]
    [-NoNewline]
    [-Encoding <FileSystemCmdletProviderEncoding>]
    [-Stream <string>]
    [<CommonParameters>]

LiteralPath

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

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

Parametreler

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

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: Default.

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

• Ascii ASCII (7 bit) karakter kümesini kullanır.
• BigEndianUnicode, büyük endian bayt sırası ile UTF-16 kullanır.
• BigEndianUTF32 UTF-32'yi büyük endian bayt düzeniyle kullanır.
• Byte Bir karakter kümesini bayt dizisine kodlar.
• Default Sistemin etkin kod sayfasına (genellikle ANSI) karşılık gelen kodlamayı kullanır.
• Oem Sistemin geçerli OEM kod sayfasına karşılık gelen kodlamayı kullanır.
• String Unicode ile aynıdır.
• Unicode UTF-16'yı little-endian bayt sırasıyla kullanır.
• Unknown Unicode ile aynıdır.
• UTF7 UTF-7 kullanır.
• UTF8 UTF-8 kullanır.
• UTF32 küçük-endian bayt düzeniyle UTF-32'yi kullanır.

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.

Parametre özellikleri

Tür:	FileSystemCmdletProviderEncoding
Default value:	Default
Kabul edilen değerler:	ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, 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, sağlayıcı komut dosyası çalıştırma aracı nesneleri alırken bunları uyguladığı için, diğer parametrelerden daha verimlidir; bu sayede PowerShell nesneler alındıktan sonra bunları filtrelemek zorunda kalmaz.

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, Zorlama salt okunur özelliği 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

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

İç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.

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

-UseTransaction

Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz. about_Transactions.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	usetx

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.

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.

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ılmıyor.

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

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

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

• 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.

İlişkili Bağlantılar

• Aliases Hakkında
• Sağlayıcılar_Hakkında
• İşlemler_Hakkında
• İçeriği Temizle
• Get-Content
• Get-Item
• Yeni Öğe
• İçerik Ayarla