Copy-Item

Moduł:: Microsoft.PowerShell.Management Module

Kopiuje element z jednej lokalizacji do innej.

Składnia

Path (domyślnie)

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

LiteralPath

Copy-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-FromSession <PSSession>]
    [-ToSession <PSSession>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Copy-Item kopiuje element z jednej lokalizacji do innej lokalizacji w tej samej przestrzeni nazw. Na przykład może skopiować plik do folderu, ale nie może skopiować pliku na dysk certyfikatu.

To polecenie cmdlet nie powoduje wycinania ani usuwania kopiowanych elementów. Określone elementy, które polecenie cmdlet może skopiować, zależy od dostawcy programu PowerShell, który uwidacznia element. Na przykład może kopiować pliki i katalogi na dysku systemu plików oraz klucze rejestru i wpisy na dysku rejestru.

To polecenie cmdlet może kopiować i zmieniać nazwy elementów w tym samym poleceniu. Aby zmienić nazwę elementu, wprowadź nową nazwę w wartości parametru Destination. Aby zmienić nazwę elementu i nie skopiować go, użyj polecenia cmdlet Rename-Item.

Przykłady

Przykład 1. Kopiowanie pliku do określonego katalogu

Ten przykład kopiuje plik mar1604.log.txt do katalogu C:\Presentation. Oryginalny plik nie jest usuwany.

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

Przykład 2. Kopiowanie zawartości katalogu do istniejącego katalogu

W tym przykładzie zawartość katalogu C:\Logfiles jest kopiowana do istniejącego katalogu C:\Drawings. Katalog Logfiles nie jest kopiowany.

Jeśli katalog Logfiles zawiera pliki w podkatalogach, te podkatalogi są kopiowane z drzewami plików nienaruszonymi. Domyślnie parametr Container jest ustawiony na wartość True, która zachowuje strukturę katalogów.

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

Uwaga / Notatka

Jeśli musisz dołączyć katalog Logfiles do kopii, usuń \* ze ścieżki . Przykład:

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

Przykład 3. Kopiowanie zawartości katalogu do nowego katalogu

Ten przykład kopiuje zawartość katalogu źródłowego C:\Logfiles i tworzy nowy katalog docelowy. Nowy katalog docelowy \Logs jest tworzony w C:\Drawings.

Aby dołączyć nazwę katalogu źródłowego, skopiuj do istniejącego katalogu docelowego, jak pokazano w Przykład 2. Możesz też nazwać nowy katalog docelowy tym samym co katalog źródłowy.

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

Uwaga / Notatka

Jeśli ścieżka zawiera \*, wszystkie zawartość pliku katalogu bez drzew podkatalogu zostaną skopiowane do nowego katalogu docelowego. Przykład:

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

Przykład 4. Kopiowanie pliku do określonego katalogu i zmienianie nazwy pliku

W tym przykładzie użyto polecenia cmdlet Copy-Item do skopiowania skryptu Get-Widget.ps1 z katalogu \\Server01\Share do katalogu \\Server12\ScriptArchive. W ramach operacji kopiowania polecenie zmienia nazwę elementu z Get-Widget.ps1 na Get-Widget.ps1.txt, aby można było dołączyć ją do wiadomości e-mail.

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