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

Description

De cmdlet Copy-Item kopieert een item van de ene locatie naar de 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 cmdlet Rename-Item.

Voorbeelden

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

In dit voorbeeld wordt het mar1604.log.txt-bestand gekopieerd naar de map C:\Presentation. 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 map Logfiles bestanden in submappen bevat, worden deze submappen gekopieerd met hun bestandsstructuren intact. De parameter Container is standaard ingesteld op True, waardoor de mapstructuur behouden blijft.

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

Notitie

Als u de Logfiles map in de kopie wilt opnemen, verwijdert u de \* uit het Pad. Bijvoorbeeld:

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

Voorbeeld 3: De inhoud van de map kopiëren naar een nieuwe map

In dit voorbeeld wordt de inhoud van de C:\Logfiles bronmap gekopieerd en wordt er een nieuwe doelmap gemaakt. De nieuwe doelmap, \Logs wordt 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, zonder de submapstructuren, gekopieerd naar de nieuwe doelmap. Bijvoorbeeld:

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 uit de \\Server01\Share map naar de \\Server12\ScriptArchive-map te kopiëren. Als onderdeel van de kopieerbewerking wijzigt de opdracht de itemnaam van Get-Widget.ps1 in Get-Widget.ps1.txt, zodat deze kan worden toegevoegd aan e-mailberichten.

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