Copy-Item

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
    [[-Destination] <String>]
    -LiteralPath <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>]

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.

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"

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 de bestandsstructuren intact. De parameter Container is standaard ingesteld op True, waardoor de mapstructuur behouden blijft.

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

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

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 veilig aan e-mailberichten kan worden toegevoegd.

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

Er wordt een sessie gemaakt op de externe computer met de naam Server01 met de referentie van Contoso\User01 en slaat de resultaten op in de variabele met de naam $Session.

De Copy-Item cmdlet kopieert test.log van de D:\Folder001 map naar de C:\Folder001_Copy map op de externe computer met behulp van de sessiegegevens die zijn opgeslagen in de $Session variabele. Het oorspronkelijke bestand wordt niet verwijderd.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "D:\Folder001\test.log" -Destination "C:\Folder001_Copy\" -ToSession $Session

Er wordt een sessie gemaakt op de externe computer met de naam Server01 met de referentie van Contoso\User01 en slaat de resultaten op in de variabele met de naam $Session.

De Copy-Item cmdlet kopieert de D:\Folder002 map naar de C:\Folder002_Copy map op de externe computer met behulp van de sessiegegevens die zijn opgeslagen in de $Session variabele. Submappen of bestanden worden niet gekopieerd zonder de schakeloptie Recurse te gebruiken. Met de bewerking wordt de Folder002_Copy map gemaakt als deze nog niet bestaat.

$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $Session

Er wordt een sessie gemaakt op de externe computer met de naam Server01 met de referentie van Contoso\User01 en slaat de resultaten op in de variabele met de naam $Session.

De Copy-Item cmdlet kopieert de volledige inhoud van de D:\Folder003 map naar de C:\Folder003_Copy map op de externe computer met behulp van de sessiegegevens die zijn opgeslagen in de $Session variabele. De submappen worden gekopieerd met hun bestandsstructuren intact. Met de bewerking wordt de Folder003_Copy map gemaakt als deze nog niet bestaat.

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -Recurse

Er wordt een sessie gemaakt op de externe computer met de naam Server01 met de referentie van Contoso\User01 en slaat de resultaten op in de variabele met de naam $Session.

De Copy-Item cmdlet kopieert scriptingexample.ps1 van de D:\Folder004 map naar de C:\Folder004_Copy map op de externe computer met behulp van de sessiegegevens die zijn opgeslagen in de $Session variabele. Het oorspronkelijke bestand wordt niet verwijderd.

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
$copyParams = @{
    Path        = "D:\Folder004\scriptingexample.ps1"
    Destination = "C:\Folder004_Copy\scriptingexample_copy.ps1"
    ToSession   = $Session
}
Copy-Item @copyParams

Er wordt een sessie gemaakt op de externe computer met de naam Server01 met de referentie van Contoso\User01 en slaat de resultaten op in de variabele met de naam $Session.

De Copy-Item cmdlet kopieert test.log van de externe C:\MyRemoteData\ naar de lokale D:\MyLocalData map met behulp van de sessiegegevens die zijn opgeslagen in de $Session variabele. Het oorspronkelijke bestand wordt niet verwijderd.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\test.log" -Destination "D:\MyLocalData\" -FromSession $Session

Er wordt een sessie gemaakt op de externe computer met de naam Server01 met de referentie van Contoso\User01 en slaat de resultaten op in de variabele met de naam $Session.

De Copy-Item cmdlet kopieert de volledige inhoud van de externe C:\MyRemoteData\scripts map naar de lokale D:\MyLocalData map met behulp van de sessiegegevens die zijn opgeslagen in de $Session variabele. Als de map scripts bestanden in submappen bevat, worden deze submappen gekopieerd met hun bestandsstructuren intact.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\" -FromSession $Session

Er wordt een sessie gemaakt op de externe computer met de naam Server01 met de referentie van Contoso\User01 en slaat de resultaten op in de variabele met de naam $Session.

De Copy-Item cmdlet kopieert de volledige inhoud van de externe C:\MyRemoteData\scripts map naar de lokale D:\MyLocalData\scripts map met behulp van de sessiegegevens die zijn opgeslagen in de $Session variabele. Omdat de parameter Recurse wordt gebruikt, maakt de bewerking de map met scripts als deze nog niet bestaat. Als de map scripts bestanden in submappen bevat, worden deze submappen gekopieerd met hun bestandsstructuren intact.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
$copyParams = @{
    Path        = "C:\MyRemoteData\scripts"
    Destination = "D:\MyLocalData\scripts"
    FromSession = $Session
    Recurse     = $true
}
Copy-Item @copyParams

In dit voorbeeld ziet u hoe u bestanden kopieert van een mapstructuur met meerdere niveaus naar één platte map. De eerste drie opdrachten tonen de bestaande mapstructuur en de inhoud van twee bestanden, beide namen file3.txt.

PS C:\temp\test> (Get-ChildItem C:\temp\tree -Recurse).FullName
C:\temp\tree\subfolder
C:\temp\tree\file1.txt
C:\temp\tree\file2.txt
C:\temp\tree\file3.txt
C:\temp\tree\subfolder\file3.txt
C:\temp\tree\subfolder\file4.txt
C:\temp\tree\subfolder\file5.txt

PS C:\temp\test> Get-Content C:\temp\tree\file3.txt
This is file3.txt in the root folder

PS C:\temp\test> Get-Content C:\temp\tree\subfolder\file3.txt
This is file3.txt in the subfolder

PS C:\temp\test> Copy-Item -Path C:\temp\tree -Filter *.txt -Recurse -Container:$false
PS C:\temp\test> (Get-ChildItem . -Recurse).FullName
C:\temp\test\subfolder
C:\temp\test\file1.txt
C:\temp\test\file2.txt
C:\temp\test\file3.txt
C:\temp\test\file4.txt
C:\temp\test\file5.txt

PS C:\temp\test> Get-Content .\file3.txt
This is file3.txt in the subfolder

De cmdlet Copy-Item heeft de parameter Container ingesteld op $false. Hierdoor wordt de inhoud van de bronmap gekopieerd, maar blijft de mapstructuur niet behouden. U ziet dat bestanden met dezelfde naam worden overschreven in de doelmap.

In dit voorbeeld ziet u de resultaten met behulp van de parameter Include om de te kopiëren items te selecteren.

In dit voorbeeld wordt de volgende mapstructuur gebruikt die de bestanden bevat die moeten worden gekopieerd:

• D:\temp\tree\example.ps1
• D:\temp\tree\example.txt
• D:\temp\tree\examples\
• D:\temp\tree\examples\example_1.txt
• D:\temp\tree\examples\example_2.txt
• D:\temp\tree\examples\subfolder\
• D:\temp\tree\examples\subfolder\test.txt

In dit voorbeeld wordt Copy-Item aangeroepen met een jokerteken voor zowel de pad- als parameters opnemen. Als u een jokerteken opgeeft voor de parameter Path, worden alle bestanden en mappen verwerkt die overeenkomen met D:\temp\tree\*. De De parameter opnemen filtert de lijst met items die moeten worden verwerkt, waardoor de bewerking wordt beperkt tot alleen de paden die beginnen met ex.

PS D:\temp\test\out> Copy-Item -Path D:\temp\tree\* -Include ex*
PS D:\temp\test\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt

De parameter Opnemen wordt toegepast op de inhoud van D:\temp\tree map om alle items te kopiëren die overeenkomen met ex*. U ziet dat de D:\temp\out\examples map zonder recursie wordt gekopieerd, maar dat geen van de inhoud ervan wordt gekopieerd.

In dit voorbeeld ziet u de resultaten met behulp van de parameter Include om de te kopiëren items te selecteren.

In dit voorbeeld wordt de volgende mapstructuur gebruikt die de bestanden bevat die moeten worden gekopieerd:

• D:\temp\tree\example.ps1
• D:\temp\tree\example.txt
• D:\temp\tree\examples\
• D:\temp\tree\examples\example_1.txt
• D:\temp\tree\examples\example_2.txt
• D:\temp\tree\examples\subfolder\
• D:\temp\tree\examples\subfolder\test.txt

In dit voorbeeld wordt Copy-Item aangeroepen met een jokerteken voor zowel de pad- als parameters opnemen. Als u een jokerteken opgeeft voor de parameter Path, worden alle bestanden en mappen verwerkt die overeenkomen met D:\temp\tree\*. De De parameter opnemen filtert de lijst met items die moeten worden verwerkt, waardoor de bewerking wordt beperkt tot alleen de paden die beginnen met ex.

D:\temp\out> Copy-Item -Path D:\temp\tree\* -Include ex* -Recurse
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt
D:\temp\out\examples\subfolder
D:\temp\out\examples\example_1.txt
D:\temp\out\examples\example_2.txt
D:\temp\out\examples\subfolder\test.txt

De parameter Opnemen wordt toegepast op de inhoud van D:\temp\tree map om alle items te kopiëren die overeenkomen met ex*. U ziet dat met recursie de map D:\temp\out\examples samen met alle bestanden en submappen wordt gekopieerd. De kopie bevat bestanden die niet overeenkomen met het insluitingsfilter. Wanneer u Copy-Itemgebruikt, zijn de filters alleen van toepassing op het hoogste niveau dat is opgegeven door de parameter Path. Vervolgens wordt recursie toegepast op deze overeenkomende items.

In dit voorbeeld ziet u hoe u de bestanden recursief kunt beperken die zijn gekopieerd van een jokerteken-overeenkomend pad naar een andere map. In voorbeeld 13 ziet u dat, omdat de parameter Opnemen parameter alleen filters op de paden die zijn omgezet voor een jokerteken dat Padopgeeft, de parameter Include niet kan worden gebruikt om de bestanden recursief uit een map te beperken. In plaats daarvan kunt u Get-ChildItem gebruiken om de items te vinden die u wilt kopiëren en door te geven aan Copy-Item.

In dit voorbeeld wordt de volgende mapstructuur gebruikt die de bestanden bevat die moeten worden gekopieerd:

• D:\temp\tree\example.ps1
• D:\temp\tree\example.txt
• D:\temp\tree\examples\
• D:\temp\tree\examples\example_1.txt
• D:\temp\tree\examples\example_2.txt
• D:\temp\tree\examples\subfolder\
• D:\temp\tree\examples\subfolder\test.txt

Als u alle items wilt kopiëren die beginnen met ex*, gebruikt u Get-ChildItem met de Recurse- en Filter parameters en sluist u de resultaten door naar Copy-Item.

D:\temp\out> Get-ChildItem -Path D:\temp\tree -Recurse -Filter ex* | Copy-Item
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example_1.txt
D:\temp\out\example_2.txt
D:\temp\out\example.ps1
D:\temp\out\example.txt

In tegenstelling tot de Copy-Itemis de parameter Filter voor Get-ChildItem van toepassing op de items die tijdens recursie zijn gedetecteerd. Hiermee kunt u items recursief zoeken, filteren en kopiëren.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een object dat het gekopieerde item vertegenwoordigt.

PowerShell bevat de volgende aliassen voor Copy-Item:

• Alle platforms:
  • copy
  • cpi
• Windows:
  • cp

Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.