Copy-Item

Modul:: Microsoft.PowerShell.Management Module

Menyalin item dari satu lokasi ke lokasi lainnya.

Sintaks

Path (Default) - FileSystem provider

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

LiteralPath - FileSystem provider

Copy-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-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]
    [<CommonParameters>]

LiteralPath - All providers

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

Deskripsi

cmdlet Copy-Item menyalin item dari satu lokasi ke lokasi lain di namespace yang sama. Misalnya, file dapat menyalin file ke folder, tetapi tidak dapat menyalin file ke drive sertifikat.

Cmdlet ini tidak memotong atau menghapus item yang sedang disalin. Item tertentu yang dapat disalin cmdlet bergantung pada penyedia PowerShell yang mengekspos item. Misalnya, file dan direktori dapat disalin dalam drive sistem file dan kunci registri dan entri di drive registri.

Cmdlet ini dapat menyalin dan mengganti nama item dalam perintah yang sama. Untuk mengganti nama item, masukkan nama baru dalam nilai parameter Tujuan . Untuk mengganti nama item dan tidak menyalinnya, gunakan cmdlet Rename-Item.

Contoh

Contoh 1: Menyalin file ke direktori yang ditentukan

Contoh ini menyalin file mar1604.log.txt ke direktori C:\Presentation. File asli tidak dihapus.

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

Contoh 2: Menyalin konten direktori ke direktori yang sudah ada

Contoh ini menyalin konten direktori C:\Logfiles ke direktori C:\Drawings yang ada. Direktori Logfiles tidak disalin.

Logfiles Jika direktori memiliki file dalam subdirektori, subdirektori tersebut disalin dengan pohon file mereka secara utuh. Secara default, parameter Kontainer diatur ke True, yang mempertahankan struktur direktori.

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

Nota

Jika jalur C:\Drawings tidak ada cmdlet menyalin semua file dari Logfiles pohon folder ke dalam satu folder C:\Drawings, menimpa file apa pun dengan nama yang sama.

Contoh 3: Menyalin direktori dan konten ke direktori baru

Contoh ini menyalin konten direktori sumber C:\Logfiles dan membuat direktori tujuan baru. Direktori tujuan baru, \Logs dibuat di C:\Drawings.

Untuk menyertakan nama direktori sumber, salin ke direktori tujuan yang ada seperti yang ditunjukkan dalam Contoh 2. Atau, beri nama direktori tujuan baru dengan sama dengan direktori sumber.

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

Nota

Jika Jalur menyertakan \*, semua konten file direktori, termasuk pohon subdirektori, disalin ke direktori tujuan baru. Contohnya:

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

Contoh 4: Salin file ke direktori yang ditentukan dan ganti nama file

Contoh ini menggunakan cmdlet Copy-Item untuk menyalin skrip Get-Widget.ps1 dari direktori \\Server01\Share ke direktori \\Server12\ScriptArchive. Sebagai bagian dari operasi salin, perintah mengubah nama item dari Get-Widget.ps1 menjadi Get-Widget.ps1.txt, sehingga dapat dilampirkan dengan aman ke pesan email.

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