Copy-Item

Referentie

Module:: Microsoft.PowerShell.Management

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

Syntax

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

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 doelparameter in. Gebruik de cmdlet om de naam van een item te wijzigen en niet te Rename-Item kopiëren.

Voorbeelden

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

In dit voorbeeld wordt het mar1604.log.txt bestand naar de C:\Presentation map gekopieerd. 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. 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 map in de Logfiles kopie wilt opnemen, verwijdert u de \* uit het pad. Bijvoorbeeld:

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

Als het pad C:\Drawings niet bestaat, kopieert de cmdlet alle bestanden uit de Logfiles map naar één bestand C:\Drawings.

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 \*, wordt alle bestandsinhoud van de map, inclusief 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 van 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"