Copy-Item

Referensi

Modul:: Microsoft.PowerShell.Management

Menyalin item dari satu lokasi ke lokasi lainnya.

Sintaks

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

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

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

Deskripsi

Copy-Item Cmdlet 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 Rename-Item cmdlet.

Contoh

Contoh 1: Menyalin file ke direktori yang ditentukan

Contoh ini menyalin mar1604.log.txt file ke C:\Presentation direktori. 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 C:\Logfiles direktori ke direktori yang ada C:\Drawings . Logfiles Direktori 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

Catatan

Jika jalur C:\Drawings tidak ada cmdlet menyalin semua file dari Logfiles folder ke dalam satu file C:\Drawings.

Contoh 3: Menyalin direktori dan konten ke direktori baru

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

Untuk menyertakan nama direktori sumber, salin ke direktori tujuan yang sudah 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

Catatan

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 Copy-Item cmdlet untuk menyalin Get-Widget.ps1 skrip dari \\Server01\Share direktori ke \\Server12\ScriptArchive direktori. 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.

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