Copy-Item

Referentie

Module:: Microsoft.PowerShell.Management

Hiermee kopieert u een item van de ene locatie naar de andere.

Syntaxis

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

De Copy-Item cmdlet kopieert een item van de ene locatie naar een andere locatie in dezelfde naamruimte. Het kan bijvoorbeeld een bestand naar een map kopiëren, maar het kan geen bestand naar een certificaatstation kopiëren.

Met deze cmdlet worden de items die worden gekopieerd, niet geknipt of verwijderd. De specifieke items die de cmdlet kan kopiëren, zijn afhankelijk van de PowerShell-provider die het item beschikbaar maakt. Het kan bijvoorbeeld bestanden en mappen kopiëren in een bestandssysteemstation en registersleutels en vermeldingen in het registerstation.

Met deze cmdlet kunt u items in dezelfde opdracht kopiëren en de naam ervan wijzigen. Als u de naam van een item wilt wijzigen, voert u de nieuwe naam in de waarde van de parameter Destination in. Als u de naam van een item wilt wijzigen en niet wilt kopiëren, gebruikt u de Rename-Item cmdlet.

Voorbeelden

Voorbeeld 1: Een bestand kopiëren naar de opgegeven map

In dit voorbeeld wordt het mar1604.log.txt bestand gekopieerd naar de C:\Presentation map. Het oorspronkelijke bestand wordt niet verwijderd.

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

Voorbeeld 2: Mapinhoud kopiëren naar een bestaande map

In dit voorbeeld wordt de inhoud van de C:\Logfiles map gekopieerd naar de bestaande C:\Drawings map. De Logfiles map wordt niet gekopieerd.

Als de Logfiles map bestanden in submappen bevat, worden deze submappen gekopieerd met hun bestandsstructuren intact. Standaard is de containerparameter ingesteld op True, waardoor de mapstructuur behouden blijft.

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

Notitie

Als het pad C:\Drawings niet bestaat, kopieert de cmdlet alle bestanden uit de Logfiles mapstructuur naar één map C:\Drawings, waarbij alle bestanden met dezelfde naam worden overschreven.

Voorbeeld 3: Map en inhoud kopiëren naar een nieuwe map

In dit voorbeeld wordt de inhoud van de C:\Logfiles bronmap gekopieerd en wordt een nieuwe doelmap gemaakt. De nieuwe doelmap wordt \Logs gemaakt in C:\Drawings.

Als u de naam van de bronmap wilt opnemen, kopieert u naar een bestaande doelmap, zoals wordt weergegeven in voorbeeld 2. Of geef de nieuwe doelmap dezelfde naam als de bronmap.

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

Notitie

Als het pad bevat \*, worden alle bestandsinhoud van de map, inclusief de submapstructuren, gekopieerd naar de nieuwe doelmap. Voorbeeld:

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

Voorbeeld 4: Een bestand kopiëren naar de opgegeven map en de naam van het bestand wijzigen

In dit voorbeeld wordt de Copy-Item cmdlet gebruikt om het Get-Widget.ps1 script van de \\Server01\Share map naar de \\Server12\ScriptArchive map te kopiëren. Als onderdeel van de kopieerbewerking wijzigt de opdracht de itemnaam in Get-Widget.ps1 Get-Widget.ps1.txt, zodat deze veilig aan e-mailberichten kan worden gekoppeld.

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