Copy-Item

Başvuru

Modül:: Microsoft.PowerShell.Management

Bir öğeyi bir konumdan diğerine kopyalar.

Sözdizimi

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

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

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

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

Description

Cmdlet, Copy-Item 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. Bir öğeyi yeniden adlandırmak için Hedef parametresinin değerine yeni adı girin. Öğeyi yeniden adlandırmak ve kopyalamamak için cmdlet'ini Rename-Item kullanın.

Örnekler

Örnek 1: Belirtilen dizine dosya kopyalama

Bu örnek, dosyayı dizinine mar1604.log.txt kopyalarC:\Presentation. Ö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, dizinin içeriğini C:\Logfiles mevcut C:\Drawings dizine kopyalar. Dizin Logfiles kopyalanmıyor.

Dizinde Logfiles 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 True olarak ayarlanır.

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

Not

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

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

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

Kaynak dizinin adını eklemek için, Örnek 2'de gö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

Not

Path 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 örnekte, betiği dizinden Copy-Item dizine kopyalamak Get-Widget.ps1 için cmdlet'i \\Server01\Share kullanılır\\Server12\ScriptArchive. Kopyalama işleminin bir parçası olarak, komut öğe adını Get-Widget.ps1Get-Widget.ps1.txtolarak değiştirir, böylece e-posta iletilerine güvenli bir şekilde eklenebilir.

$copyParams = @{
    Path        = "\\Server01\Share\Get-Widget.ps1"
    Destination = "\\Server12\ScriptArchive\Get-Widget.ps1.txt"
}
Copy-Item @copyParams