Copy-Item

Modul:: Microsoft.PowerShell.Management Module

Elem másolása egyik helyről a másikra.

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

Description

A Copy-Item parancsmag egy elemet másol egy helyről egy másik helyre ugyanabban a névtérben. Például átmásolhat egy fájlt egy mappába, de nem tud fájlokat másolni egy tanúsítványmeghajtóra.

Ez a parancsmag nem vágja ki vagy törli a másolt elemeket. A parancsmag által másolható elemek az elemet elérhetővé tevő PowerShell-szolgáltatótól függenek. Másolhat például fájlokat és könyvtárakat egy fájlrendszer-meghajtón, valamint a beállításkulcsokat és bejegyzéseket a beállításjegyzék-meghajtón.

Ez a parancsmag ugyanabban a parancsban másolhatja és átnevezheti az elemeket. Egy elem átnevezéséhez írja be az új nevet a Cél paraméter értékébe. Ha át szeretne nevezni egy elemet, és nem másolja, használja a Rename-Item parancsmagot.

Példák

1. példa: Fájl másolása a megadott könyvtárba

Ez a példa a mar1604.log.txt fájlt a C:\Presentation könyvtárba másolja. Az eredeti fájl nem törlődik.

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

2. példa: Könyvtártartalom másolása meglévő könyvtárba

Ez a példa a C:\Logfiles könyvtár tartalmát a meglévő C:\Drawings könyvtárba másolja. A Logfiles könyvtár nincs másolva.

Ha a Logfiles könyvtárban vannak alkönyvtárakban lévő fájlok, a program ezeket az alkönyvtárakat érintetlen fájlfákkal másolja. Alapértelmezés szerint a Tároló paraméter értéke Igaz, amely megőrzi a címtárstruktúrát.

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

Megjegyzés:

Ha a C:\Drawings elérési út nem létezik, a parancsmag az összes fájlt a Logfiles mappafából egyetlen mappába másolja C:\Drawings, felülírva az azonos nevű fájlokat.

3. példa: Könyvtár és tartalom másolása új könyvtárba

Ez a példa átmásolja a C:\Logfiles forráskönyvtár tartalmát, és létrehoz egy új célkönyvtárat. A \Logs új célkönyvtár C:\Drawingsjön létre.

Ha fel szeretné venni a forráskönyvtár nevét, másolja át egy meglévő célkönyvtárba a 2. példa. Vagy nevezze el az új célkönyvtárat úgy, hogy ugyanaz legyen, mint a forráskönyvtár.

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

Megjegyzés:

Ha a Elérési út\*tartalmaz, a könyvtár összes fájltartalma, beleértve az alkönyvtárfákat is, az új célkönyvtárba lesz másolva. Például:

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

4. példa: Fájl másolása a megadott könyvtárba, majd a fájl átnevezése

Ez a példa a Copy-Item parancsmaggal másolja a Get-Widget.ps1 szkriptet a \\Server01\Share könyvtárból a \\Server12\ScriptArchive könyvtárba. A másolási művelet részeként a parancs Get-Widget.ps1-ról Get-Widget.ps1.txt-ra módosítja az elem nevét, így biztonságosan csatolható az e-mailekhez.

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