Copy-Item

Moduł:: Microsoft.PowerShell.Management Module

Kopiuje element z jednej lokalizacji do innej.

Składnia

Path (Default) - FileSystem provider

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

LiteralPath - FileSystem provider

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

Path (Default) - All providers

Copy-Item
    [-Path] <string[]>
    [[-Destination] <string>]
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath - All providers

Copy-Item
    [[-Destination] <string>]
    -LiteralPath <string[]>
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<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 ich 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 ścieżka C:\Drawings nie istnieje, polecenie cmdlet kopiuje wszystkie pliki z drzewa folderów Logfiles do jednego folderu C:\Drawings, zastępując wszystkie pliki o tej samej nazwie.

Przykład 3. Kopiowanie katalogu i zawartości 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, w tym drzewa 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 bezpiecznie dołączyć ją do wiadomości e-mail.

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