Copy-Item

Modül:

Microsoft.PowerShell.Management Module

Bir öğeyi bir konumdan diğerine kopyalar.

Syntax

Path (Default) - FileSystem provider

Copy-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-FromSession <PSSession>]
    [-ToSession <PSSession>]
    [<CommonParameters>]

LiteralPath - FileSystem provider

Copy-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-FromSession <PSSession>]
    [-ToSession <PSSession>]
    [<CommonParameters>]

Path (Default) - All providers

Copy-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

LiteralPath - All providers

Copy-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Description

Copy-Item cmdlet'i bir öğeyi bir konumdan aynı ad alanındaki başka bir konuma kopyalar. Örneğin, bir dosyayı bir klasöre kopyalayabilir, ancak bir dosyayı sertifika sürücüsüne kopyalayamaz.

Bu cmdlet kopyalanan öğeleri kesmez veya silmez. Cmdlet'in kopyalayabileceğiniz belirli öğeler, öğeyi kullanıma sunan PowerShell sağlayıcısına bağlıdır. Örneğin, bir dosya sistemi sürücüsündeki dosyaları ve dizinleri ve kayıt defteri sürücüsündeki kayıt defteri anahtarlarını ve girdilerini kopyalayabilir.

Bu cmdlet aynı komuttaki öğeleri kopyalayabilir ve yeniden adlandırabilir. Öğeyi yeniden adlandırmak için, Hedef parametresinin değerine yeni adı girin. Öğeyi yeniden adlandırmak ve kopyalamamak için Rename-Item cmdlet'ini kullanın.

Örnekler

Örnek 1: Belirtilen dizine dosya kopyalama

Bu örnek, mar1604.log.txt dosyasını C:\Presentation dizinine kopyalar. Özgün dosya silinmez.

Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"

Örnek 2: Dizin içeriğini var olan bir dizine kopyalama

Bu örnek, C:\Logfiles dizininin içeriğini mevcut C:\Drawings dizinine kopyalar. Logfiles dizini kopyalanır.

Logfiles dizininde alt dizinlerde dosyalar varsa, bu alt dizinler dosya ağaçları olduğu gibi kopyalanır. Varsayılan olarak, Container parametresi, dizin yapısını koruyan Trueolarak ayarlanır.

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -Recurse

Uyarı

yol C:\Drawings yoksa, cmdlet Logfiles klasör ağacındaki tüm dosyaları C:\Drawingstek bir klasöre kopyalar ve aynı ada sahip dosyaların üzerine yazar.

Örnek 3: Dizini ve içeriği yeni bir dizine kopyalama

Bu örnek, C:\Logfiles kaynak dizininin içeriğini kopyalar ve yeni bir hedef dizin oluşturur. \Logs yeni hedef dizini C:\Drawingsiçinde oluşturulur.

Kaynak dizinin adını eklemek için, Örnek 2gösterildiği gibi var olan bir hedef dizine kopyalayın. Alternatif olarak, yeni hedef dizini kaynak dizinle aynı şekilde adlandırın.

Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings\Logs" -Recurse

Uyarı

Yolu\*içeriyorsa, alt dizin ağaçları da dahil olmak üzere dizinin tüm dosya içeriği yeni hedef dizine kopyalanır. Örneğin:

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse

Örnek 4: Bir dosyayı belirtilen dizine kopyalayın ve dosyayı yeniden adlandırın

Bu örnek, Copy-Item betiğini Get-Widget.ps1 dizininden \\Server01\Share dizinine kopyalamak için \\Server12\ScriptArchive cmdlet'ini kullanır. Kopyalama işleminin bir parçası olarak komut, e-posta iletilerine güvenli bir şekilde eklenebilmesi için öğe adını Get-Widget.ps1 olarak Get-Widget.ps1.txtolarak değiştirir.

Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"

Örnek 5: Uzak bilgisayara dosya kopyalama

kimlik bilgileriyle Contoso\User01 adlı uzak bilgisayarda bir oturum oluşturulur ve sonuçları $Sessionadlı değişkende depolar.

Copy-Item cmdlet'i, test.log değişkeninde depolanan oturum bilgilerini kullanarak D:\Folder001C:\Folder001_Copy klasöründen uzak bilgisayardaki $Session klasörüne kopyalar. Özgün dosya silinmez.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "D:\Folder001\test.log" -Destination "C:\Folder001_Copy\" -ToSession $Session

Örnek 6: Klasörü uzak bilgisayara kopyalama

kimlik bilgileriyle Contoso\User01 adlı uzak bilgisayarda bir oturum oluşturulur ve sonuçları $Sessionadlı değişkende depolar.

Copy-Item cmdlet'i, D:\Folder002 değişkeninde depolanan oturum bilgilerini kullanarak C:\Folder002_Copy klasörünü uzak bilgisayardaki $Session dizinine kopyalar. Herhangi bir alt klasör veya dosya Yineleme anahtarı kullanılmadan kopyalanmaz. İşlem, henüz yoksa Folder002_Copy klasörünü oluşturur.

$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $Session

Örnek 7: Bir klasörün içeriğinin tamamını yinelemeli olarak uzak bilgisayara kopyalama

kimlik bilgileriyle Contoso\User01 adlı uzak bilgisayarda bir oturum oluşturulur ve sonuçları $Sessionadlı değişkende depolar.

Copy-Item cmdlet'i, D:\Folder003 değişkeninde depolanan oturum bilgilerini kullanarak tüm içeriği C:\Folder003_Copy klasöründen uzak bilgisayardaki $Session dizinine kopyalar. Alt klasörler, dosya ağaçları olduğu gibi kopyalanır. İşlem, henüz yoksa Folder003_Copy klasörünü oluşturur.

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -Recurse

Örnek 8: Bir dosyayı uzak bilgisayara kopyalama ve sonra dosyayı yeniden adlandırma

kimlik bilgileriyle Contoso\User01 adlı uzak bilgisayarda bir oturum oluşturulur ve sonuçları $Sessionadlı değişkende depolar.

Copy-Item cmdlet'i, scriptingexample.ps1 değişkeninde depolanan oturum bilgilerini kullanarak D:\Folder004C:\Folder004_Copy klasöründen uzak bilgisayardaki $Session klasörüne kopyalar. Özgün dosya silinmez.

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder004\scriptingexample.ps1" -Destination "C:\Folder004_Copy\scriptingexample_copy.ps1" -ToSession $Session

Örnek 9: Uzak dosyayı yerel bilgisayara kopyalama

kimlik bilgileriyle Contoso\User01 adlı uzak bilgisayarda bir oturum oluşturulur ve sonuçları $Sessionadlı değişkende depolar.

Copy-Item cmdlet'i, test.log değişkeninde depolanan oturum bilgilerini kullanarak C:\MyRemoteData\ uzak D:\MyLocalData yerel $Session klasörüne kopyalar. Özgün dosya silinmez.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\test.log" -Destination "D:\MyLocalData\" -FromSession $Session

Örnek 10: Uzak klasörün tüm içeriğini yerel bilgisayara kopyalama

kimlik bilgileriyle Contoso\User01 adlı uzak bilgisayarda bir oturum oluşturulur ve sonuçları $Sessionadlı değişkende depolar.

Copy-Item cmdlet'i, C:\MyRemoteData\scripts değişkeninde depolanan oturum bilgilerini kullanarak uzak D:\MyLocalData klasöründeki içeriğin tamamını yerel $Session klasörüne kopyalar. Betikler klasöründe alt klasörlerde dosyalar varsa, bu alt klasörler dosya ağaçları olduğu gibi kopyalanır.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\" -FromSession $Session

Örnek 11: Uzak klasörün tüm içeriğini yinelemeli olarak yerel bilgisayara kopyalama

kimlik bilgileriyle Contoso\User01 adlı uzak bilgisayarda bir oturum oluşturulur ve sonuçları $Sessionadlı değişkende depolar.

Copy-Item cmdlet'i, C:\MyRemoteData\scripts değişkeninde depolanan oturum bilgilerini kullanarak uzak D:\MyLocalData\scripts klasöründeki içeriğin tamamını yerel $Session klasörüne kopyalar. Yineleme parametresi kullanıldığından, işlem betikler klasörünü henüz yoksa oluşturur. Betikler klasöründe alt klasörlerde dosyalar varsa, bu alt klasörler dosya ağaçları olduğu gibi kopyalanır.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\scripts" -FromSession $Session -Recurse

Örnek 12: Bir klasör ağacındaki dosyaları yinelemeli olarak geçerli klasöre kopyalama

Bu örnekte, çok düzeyli bir klasör yapısındaki dosyaların tek bir düz klasöre nasıl kopyalanması gösterilmektedir. İlk üç komut, mevcut klasör yapısını ve iki dosyanın içeriğini gösterir; her ikisi de file3.txt.

PS C:\temp\test> (Get-ChildItem C:\temp\tree -Recurse).FullName
C:\temp\tree\subfolder
C:\temp\tree\file1.txt
C:\temp\tree\file2.txt
C:\temp\tree\file3.txt
C:\temp\tree\subfolder\file3.txt
C:\temp\tree\subfolder\file4.txt
C:\temp\tree\subfolder\file5.txt

PS C:\temp\test> Get-Content C:\temp\tree\file3.txt
This is file3.txt in the root folder

PS C:\temp\test> Get-Content C:\temp\tree\subfolder\file3.txt
This is file3.txt in the subfolder

PS C:\temp\test> Copy-Item -Path C:\temp\tree -Filter *.txt -Recurse -Container:$false
PS C:\temp\test> (Get-ChildItem . -Recurse).FullName
C:\temp\test\subfolder
C:\temp\test\file1.txt
C:\temp\test\file2.txt
C:\temp\test\file3.txt
C:\temp\test\file4.txt
C:\temp\test\file5.txt

PS C:\temp\test> Get-Content .\file3.txt
This is file3.txt in the subfolder

Copy-Item cmdlet'inde Container parametresi $falseolarak ayarlanmıştır. Bu, kaynak klasörün içeriğinin kopyalanmasına neden olur, ancak klasör yapısını korumaz. Hedef klasörde aynı ada sahip dosyaların üzerine yazıldığını unutmayın.

Örnek 13: Özyineleme olmadan öğeleri kopyalamak için filtreleri kullanma

Bu örnekte, kopyalanacak öğeleri seçmek için include parametresi kullanılarak elde edilen sonuçlar gösterilir.

Bu örnek, kopyalanacak dosyaları içeren aşağıdaki klasör yapısını kullanır:

• D:\temp\tree\example.ps1
• D:\temp\tree\example.txt
• D:\temp\tree\examples\
• D:\temp\tree\examples\example_1.txt
• D:\temp\tree\examples\example_2.txt
• D:\temp\tree\examples\subfolder\
• D:\temp\tree\examples\subfolder\test.txt

Bu örnekte, Copy-Item hem Yol hem de ekle parametreleri için joker karakterle çağrılır. Path parametresi için joker karakter belirtilmesi, D:\temp\tree\*ile eşleşen tüm dosya ve klasörleri işlemesini sağlar. Include parametresi, işlenmek üzere öğe listesini filtreler ve işlemi yalnızca exile başlayan yollarla sınırlar.

PS D:\temp\test\out> Copy-Item -Path D:\temp\tree\* -Include ex*
PS D:\temp\test\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt

Include parametresi, D:\temp\treeile eşleşen tüm öğeleri kopyalamak için ex* klasörünün içeriğine uygulanır. Özyineleme olmadan D:\temp\out\examples klasörünün kopyalandığını ancak içeriğinin hiçbirinin kopyalanmadığını fark edin.

Örnek 14: Özyinelemeli öğeleri kopyalamak için filtreleri kullanma

Bu örnekte, kopyalanacak öğeleri seçmek için include parametresi kullanılarak elde edilen sonuçlar gösterilir.

Bu örnek, kopyalanacak dosyaları içeren aşağıdaki klasör yapısını kullanır:

• D:\temp\tree\example.ps1
• D:\temp\tree\example.txt
• D:\temp\tree\examples\
• D:\temp\tree\examples\example_1.txt
• D:\temp\tree\examples\example_2.txt
• D:\temp\tree\examples\subfolder\
• D:\temp\tree\examples\subfolder\test.txt

Bu örnekte, Copy-Item hem Yol hem de ekle parametreleri için joker karakterle çağrılır. Path parametresi için joker karakter belirtilmesi, D:\temp\tree\*ile eşleşen tüm dosya ve klasörleri işlemesini sağlar. Include parametresi, işlenmek üzere öğe listesini filtreler ve işlemi yalnızca exile başlayan yollarla sınırlar.

D:\temp\out> Copy-Item -Path D:\temp\tree\* -Include ex* -Recurse
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt
D:\temp\out\examples\subfolder
D:\temp\out\examples\example_1.txt
D:\temp\out\examples\example_2.txt
D:\temp\out\examples\subfolder\test.txt

Include parametresi, D:\temp\treeile eşleşen tüm öğeleri kopyalamak için ex* klasörünün içeriğine uygulanır. Özyineleme ile D:\temp\out\examples klasörünün tüm dosyalar ve alt klasörlerle birlikte kopyalandığını fark edin. Kopya, ekleme filtresiyle eşleşmeyen dosyaları içerir. Copy-Itemkullanırken filtreler yalnızca Path parametresi tarafından belirtilen en üst düzeye uygulanır. Ardından özyineleme bu eşleşen öğelere uygulanır.

Uyarı

Exclude parametresinin davranışı, işlemi yalnızca desenle eşleşmeyen yollarla sınırlaması dışında, bu örnekte açıklananla aynıdır.

Örnek 15: Dosyaları joker karakterle belirtilen bir yoldan özyinelemeli olarak kopyalanacak şekilde sınırlandırma

Bu örnekte joker karakter eşleştirme yolundan başka bir klasöre özyinelemeli olarak kopyalanan dosyaların nasıl sınırlandırıldığı gösterilmektedir. Örnek 13'te, Include parametresi yalnızca joker karakter Pathiçin çözümlenen yollara filtre uygulandığından, Include parametresinin bir klasörden özyinelemeli olarak kopyalanan dosyaları sınırlamak için kullanılamadığını gösterir. Bunun yerine, kopyalamak istediğiniz öğeleri bulmak ve bu öğeleri Get-ChildItemgeçirmek için Copy-Item kullanabilirsiniz.

Bu örnek, kopyalanacak dosyaları içeren aşağıdaki klasör yapısını kullanır:

• D:\temp\tree\example.ps1
• D:\temp\tree\example.txt
• D:\temp\tree\examples\
• D:\temp\tree\examples\example_1.txt
• D:\temp\tree\examples\example_2.txt
• D:\temp\tree\examples\subfolder\
• D:\temp\tree\examples\subfolder\test.txt

ex*ile başlayan tüm öğeleri kopyalamak için Get-ChildItemYineleme ve Filter parametreleriyle kullanın ve sonuçları Copy-Item'e yöneltin.

D:\temp\out> Get-ChildItem -Path D:\temp\tree -Recurse -Filter ex* | Copy-Item
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example_1.txt
D:\temp\out\example_2.txt
D:\temp\out\example.ps1
D:\temp\out\example.txt

Copy-Itemaksine, için Get-ChildItem parametresi özyineleme sırasında bulunan öğeler için geçerlidir. Bu, öğeleri yinelemeli olarak bulmanıza, filtrelemenize ve kopyalamanıza olanak tanır.

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

-Container

Bu cmdlet'in kopyalama işlemi sırasında kapsayıcı nesnelerini koruduğunu gösterir. Varsayılan olarak, Container parametresi Trueolarak ayarlanır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	True
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

-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:	Current user
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

-Destination

Yeni konumun yolunu belirtir. Varsayılan değer geçerli dizindir.

Kopyalanan öğeyi yeniden adlandırmak için, Hedef parametresinin değerinde yeni bir ad belirtin.

Parametre özellikleri

Tür:	String
Default value:	Current directory
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	1
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

-Exclude

Bu cmdlet'in işlemini sınırlamak için "*.txt"gibi bir veya daha fazla yol öğesi veya deseni belirtir. Bu parametrenin değeri, son sonuçları değil, Path parametresinin joker karakter eşleştirme sonucuna göre filtrelenir. Bu parametre yalnızca Yol bir veya daha fazla joker karakterle belirtildiğinde geçerlidir. Bu parametre yalnızca Path parametresi için çözümlenen yollarda filtrelendiğinden, Yineleme parametresiyle alt klasörlerde özyineleme yaparken bulunan hiçbir öğeyi filtrelemez.

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

Bu cmdlet'in salt okunur bir dosya veya diğer ad üzerinden kopyalama gibi başka türlü değiştirilmeyecek öğeleri kopyalandığını gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
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

-FromSession

Bu, FileSystem sağlayıcısı tarafından sağlanan dinamik bir parametredir.

Uzak dosyanın kopyalandığı PSSession nesnesini belirtin. Bu parametreyi kullandığınızda, Path ve LiteralPath parametreleri uzak makinedeki yerel yola başvurur.

Daha fazla bilgi için bkz. about_FileSystem_Provider.

Parametre özellikleri

Tür:	PSSession
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

Bu cmdlet'in işlemini sınırlamak için "*.txt"gibi bir veya daha fazla yol öğesi veya deseni belirtir. Bu parametrenin değeri, son sonuçları değil, Path parametresinin joker karakter eşleştirme sonucuna göre filtrelenir. Bu parametre yalnızca Yol bir veya daha fazla joker karakterle belirtildiğinde geçerlidir. Bu parametre yalnızca Path parametresi için çözümlenen yollarda filtrelendiğinden, Yineleme parametresiyle alt klasörlerde özyineleme yaparken bulunan hiçbir öğeyi filtrelemez.

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

-PassThru

Üzerinde çalıştığınız öğeyi 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:	False
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

Dize dizisi olarak, kopyalanacak öğelerin yolunu belirtir. Joker karakterlere izin verilir.

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

-Recurse

Bu cmdlet'in özyinelemeli bir kopya yaptığını gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
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

-ToSession

Bu, FileSystem sağlayıcısı tarafından sağlanan dinamik bir parametredir.

Uzak dosyanın kopyalandığı PSSession nesnesini belirtin. Bu parametreyi kullandığınızda, Hedef parametresi uzak makinedeki yerel yola başvurur.

Daha fazla bilgi için bkz. about_FileSystem_Provider.

Parametre özellikleri

Tür:	PSSession
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

-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

String

Bu cmdlet'e bir yolu içeren bir dizeyi aktarabilirsiniz.

Çıkışlar

None

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

PSObject

PassThru parametresini kullandığınızda, bu cmdlet kopyalanan öğeyi temsil eden bir nesne döndürür.

Notlar

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

• copy
• cp
• cpi

Bu cmdlet, 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

• Sağlayıcılar_Hakkında
• Öğe Temizle
• Get-Item
• Get-PSProvider
• Invoke-Item
• Öğeyi Taşı
• Yeni Öğe
• Ögeyi Kaldır
• Öğeyi Yeniden Adlandır
• Set-Item komutu