Copy-Item

モジュール:

Microsoft.PowerShell.Management

項目をある場所から別の場所にコピーします。

構文

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

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

説明

コマンドレットは Copy-Item 、ある場所から同じ名前空間内の別の場所に項目をコピーします。 たとえば、ファイルをフォルダーにコピーすることはできますが、ファイルを証明書ドライブにコピーすることはできません。

このコマンドレットは、コピーするアイテムを切り取ったり削除したりしません。 コマンドレットがコピーできる特定の項目は、アイテムを公開する PowerShell プロバイダーによって異なります。 たとえば、ファイル システム ドライブ内のファイルとディレクトリ、レジストリ ドライブ内のレジストリ キーとエントリをコピーできます。

このコマンドレットは、同じコマンド内の項目をコピーして名前を変更できます。 項目の名前を変更するには、 Destination パラメーターの値に新しい名前を入力します。 アイテムの名前を変更し、コピーしない場合は、 コマンドレットを Rename-Item 使用します。

例

例 1: 指定したディレクトリにファイルをコピーする

次の使用例は、ファイルを mar1604.log.txt ディレクトリに C:\Presentation コピーします。 元のファイルは削除されません。

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

例 2: ディレクトリの内容を既存のディレクトリにコピーする

次の使用例は、ディレクトリの内容を既存C:\DrawingsのC:\Logfilesディレクトリにコピーします。 ディレクトリは Logfiles コピーされません。

ディレクトリに Logfiles サブディレクトリにファイルがある場合、それらのサブディレクトリはファイル ツリーをそのまま使用してコピーされます。 既定では、 Container パラメーターは True に設定され、ディレクトリ構造が保持されます。

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

注意

パス C:\Drawings が存在しない場合、コマンドレットはフォルダーからすべてのファイルを Logfiles 1 つのファイル C:\Drawingsにコピーします。

例 3: ディレクトリと内容を新しいディレクトリにコピーする

次の使用例は、ソース ディレクトリの内容を C:\Logfiles コピーし、新しい宛先ディレクトリを作成します。 新しい宛先ディレクトリ \Logs が で C:\Drawings作成されます。

ソース ディレクトリの名前を含めるには、 例 2 に示すように既存の宛先ディレクトリにコピーします。 または、新しい宛先ディレクトリにソース ディレクトリと同じ名前を付けます。

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

注意

Path に が含まれている\*場合、サブディレクトリ ツリーを含むすべてのディレクトリのファイル内容が新しいコピー先ディレクトリにコピーされます。 次に例を示します。

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

例 4: 指定したディレクトリにファイルをコピーし、ファイルの名前を変更する

この例では、 コマンドレットを Copy-Item 使用して、 Get-Widget.ps1 ディレクトリから \\Server01\Share ディレクトリにスクリプトを \\Server12\ScriptArchive コピーします。 コピー操作の一環として、コマンドはアイテム名を から Get-Widget.ps1 に Get-Widget.ps1.txt変更し、電子メール メッセージに安全に添付できるようにします。

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

例 5: リモート コンピューターにファイルをコピーする

セッションは、 の資格情報を使用して Server01 という名前の Contoso\User01 リモート コンピューターに作成され、 という名前 $Sessionの変数に結果が格納されます。

コマンドレットはCopy-Item、 変数にD:\Folder001格納されているセッション情報をC:\Folder001_Copy使用して、 フォルダーからリモート コンピューター上のフォルダーに$Sessionコピーtest.logします。 元のファイルは削除されません。

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

例 6: リモート コンピューターにフォルダーをコピーする

セッションは、 の資格情報を使用して Server01 という名前の Contoso\User01 リモート コンピューターに作成され、 という名前 $Sessionの変数に結果が格納されます。

コマンドレットはCopy-Item、 変数にD:\Folder002C:\Folder002_Copy格納されているセッション情報を使用して、リモート コンピューター上のディレクトリにフォルダーを$Sessionコピーします。 サブフォルダーまたはファイルは、 Recurse スイッチを使用せずにコピーされません。 フォルダーがまだ存在しない場合は、この操作によって作成 Folder002_Copy されます。

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

例 7: フォルダーの内容全体をリモート コンピューターに再帰的にコピーする

セッションは、 の資格情報を使用して Server01 という名前の Contoso\User01 リモート コンピューターに作成され、 という名前 $Sessionの変数に結果が格納されます。

コマンドレットはCopy-Item、 変数に格納されているセッション情報をD:\Folder003使用して、フォルダーの内容全体をリモート コンピューター上のディレクトリに$SessionコピーしますC:\Folder003_Copy。 サブフォルダーは、ファイル ツリーをそのまま使用してコピーされます。 フォルダーがまだ存在しない場合は、この操作によって作成 Folder003_Copy されます。

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

例 8: リモート コンピューターにファイルをコピーし、ファイルの名前を変更する

セッションは、 の資格情報を使用して Server01 という名前の Contoso\User01 リモート コンピューターに作成され、 という名前 $Sessionの変数に結果が格納されます。

コマンドレットはCopy-Item、 変数にD:\Folder004格納されているセッション情報をC:\Folder004_Copy使用して、 フォルダーからリモート コンピューター上のフォルダーに$Sessionコピーscriptingexample.ps1します。 元のファイルは削除されません。

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

例 9: リモート ファイルをローカル コンピューターにコピーする

セッションは、 の資格情報を使用して Server01 という名前の Contoso\User01 リモート コンピューターに作成され、 という名前 $Sessionの変数に結果が格納されます。

コマンドレットは Copy-Item 、 test.log 変数に格納されているセッション情報を使用して、リモート C:\MyRemoteData\ からローカル D:\MyLocalData フォルダーに $Session コピーします。 元のファイルは削除されません。

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

例 10: リモート フォルダーの内容全体をローカル コンピューターにコピーする

セッションは、 の資格情報を使用して Server01 という名前の Contoso\User01 リモート コンピューターに作成され、 という名前 $Sessionの変数に結果が格納されます。

コマンドレットは Copy-Item 、 変数に格納されているセッション情報を使用して、リモート C:\MyRemoteData\scripts フォルダーからローカル D:\MyLocalData フォルダーに内容全体を $Session コピーします。 scripts フォルダーにサブフォルダー内のファイルがある場合、それらのサブフォルダーはファイル ツリーはそのままコピーされます。

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

例 11: リモート フォルダーの内容全体をローカル コンピューターに再帰的にコピーする

セッションは、 の資格情報を使用して Server01 という名前の Contoso\User01 リモート コンピューターに作成され、 という名前 $Sessionの変数に結果が格納されます。

コマンドレットは Copy-Item 、 変数に格納されているセッション情報を使用して、リモート C:\MyRemoteData\scripts フォルダーからローカル D:\MyLocalData\scripts フォルダーに内容全体を $Session コピーします。 Recurse パラメーターが使用されるため、スクリプト フォルダーがまだ存在しない場合は、この操作によって scripts フォルダーが作成されます。 scripts フォルダーにサブフォルダー内のファイルがある場合、それらのサブフォルダーはファイル ツリーはそのままコピーされます。

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

例 12: フォルダー ツリーから現在のフォルダーにファイルを再帰的にコピーする

この例では、複数レベルのフォルダー構造から 1 つのフラット フォルダーにファイルをコピーする方法を示します。 最初の 3 つのコマンドは、既存のフォルダー構造と 2 つのファイルの内容 (両方の名前) を示しています 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

コマンドレットの Copy-ItemContainer パラメーターは に $false設定されています。 これにより、ソース フォルダーの内容がコピーされますが、フォルダー構造は保持されません。 同じ名前のファイルがコピー先フォルダーに上書きされていることに注意してください。

例 13: フィルターを使用して再帰なしでアイテムをコピーする

この例では、 Include パラメーターを使用してコピーする項目を選択した結果を示します。

この例では、コピーするファイルを含む次のフォルダー構造を使用します。

• 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

この例では、 は PathCopy-Item パラメーターと Include パラメーターの両方にワイルドカードを使用して 呼び出されます。 Path パラメーターにワイルドカードを指定すると、 と一致D:\temp\tree\*するすべてのファイルとフォルダーが確実に処理されます。 Include パラメーターは、処理する項目の一覧をフィルター処理し、操作を で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

Include パラメーターは、 と一致ex*するすべてのアイテムをコピーするためにフォルダーのD:\temp\tree内容に適用されます。 再帰を行わないと、 D:\temp\out\examples フォルダーはコピーされますが、その内容はコピーされません。

例 14: フィルターを使用して再帰を含むアイテムをコピーする

この例では、 Include パラメーターを使用してコピーする項目を選択した結果を示します。

この例では、コピーするファイルを含む次のフォルダー構造を使用します。

• 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

この例では、 は PathCopy-Item パラメーターと Include パラメーターの両方にワイルドカードを使用して 呼び出されます。 Path パラメーターにワイルドカードを指定すると、 と一致D:\temp\tree\*するすべてのファイルとフォルダーが確実に処理されます。 Include パラメーターは、処理する項目の一覧をフィルター処理し、操作を で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

Include パラメーターは、 と一致ex*するすべてのアイテムをコピーするためにフォルダーのD:\temp\tree内容に適用されます。 再帰では、 D:\temp\out\examples フォルダーがすべてのファイルとサブフォルダーと共にコピーされます。 コピーには、インクルード フィルターと一致 しない ファイルが含まれます。 を使用 Copy-Itemする場合、フィルターは Path パラメーターで指定された最上位レベルにのみ適用されます。 次に、一致する項目に再帰が適用されます。

注意

Exclude パラメーターの動作は、この例で説明した動作と同じですが、パターンに一致しないパスのみに操作が制限される点が異なります。

例 15: ワイルドカード指定のパスから再帰的にコピーするようにファイルを制限する

この例では、ワイルドカード一致パスから別のフォルダーに再帰的にコピーされるファイルを制限する方法を示します。 例 13 は、 Include パラメーターがワイルドカードを指定する Path に対して解決されたパスのみをフィルター処理するため、 Include パラメーターを使用してフォルダーから再帰的にコピーされるファイルを制限できないことを示しています。 代わりに、 を使用 Get-ChildItem してコピーする項目を検索し、それらの項目を に Copy-Item渡すことができます。

この例では、コピーするファイルを含む次のフォルダー構造を使用します。

• 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

でex*始まるすべての項目をコピーするには、Recurse パラメーターと Filter パラメーターを使用して を使用Get-ChildItemし、結果を に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

とは異なり、 Copy-Itemの Filter パラメーター Get-ChildItem は、再帰中に検出された項目に適用されます。 これにより、アイテムを検索、フィルター処理、および再帰的にコピーできます。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

このコマンドレットは、コピー操作中にコンテナー オブジェクトを保持することを示します。 既定では、 Container パラメーターは True に設定 されています。

Type:	SwitchParameter
Position:	Named
Default value:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

注意

このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。 別のユーザーを偽装したり、このコマンドレットの実行時に資格情報を昇格したりするには、 Invoke-Command を使用します。

Type:	PSCredential
Position:	Named
Default value:	Current user
Accept pipeline input:	True
Accept wildcard characters:	False

-Destination

新しい場所のパスを指定します。 既定値は、現在のディレクトリです。

コピーするアイテムの名前を変更するには、 Destination パラメーターの値に新しい名前を指定します。

Type:	String
Position:	1
Default value:	Current directory
Accept pipeline input:	True
Accept wildcard characters:	False

-Exclude

このコマンドレットの操作を制限するために、 などの "*.txt"1 つ以上のパス要素またはパターンを指定します。 このパラメーターの値は、最終的な結果ではなく、 Path パラメーターのワイルドカード一致結果に対してフィルター処理されます。 このパラメーターは、 Path が 1 つ以上のワイルドカードで指定されている場合にのみ有効です。 このパラメーターは Path パラメーターに解決されたパスのみをフィルター処理するため、 Recurse パラメーターを使用して子フォルダーを再帰するときに検出された項目はフィルター処理されません。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-Filter

Path パラメーターを修飾するフィルターを指定します。 FileSystem プロバイダーは、フィルターの使用をサポートする唯一のインストール済み PowerShell プロバイダーです。 FileSystem フィルター言語の構文は、about_Wildcardsで確認できます。 フィルターは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにプロバイダーによって適用されるため、他のパラメーターよりも効率的です。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-Force

このコマンドレットは、読み取り専用ファイルまたはエイリアスのコピーなど、変更できないアイテムをコピーすることを示します。

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FromSession

これは、 FileSystem プロバイダーが使用できる動的パラメーターです。

リモート・ファイルのコピー元の PSSession オブジェクトを指定します。 このパラメーターを使用すると、 Path パラメーターと LiteralPath パラメーターはリモート コンピューター上のローカル パスを参照します。

詳細については、「 about_FileSystem_Provider」を参照してください。

Type:	PSSession
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Include

このコマンドレットの操作を制限するために、 などの "*.txt"1 つ以上のパス要素またはパターンを指定します。 このパラメーターの値は、最終的な結果ではなく、 Path パラメーターのワイルドカード一致結果に対してフィルター処理されます。 このパラメーターは、 Path が 1 つ以上のワイルドカードで指定されている場合にのみ有効です。 このパラメーターは Path パラメーターに解決されたパスのみをフィルター処理するため、 Recurse パラメーターを使用して子フォルダーを再帰するときに検出された項目はフィルター処理されません。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-LiteralPath

1 つ以上の場所へのパスを指定します。 LiteralPath の値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 一重引用符は、文字をエスケープ シーケンスとして解釈しないように PowerShell に指示します。

詳細については、「 about_Quoting_Rules」を参照してください。

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

作業中のアイテムを表す オブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

文字列配列として、コピーする項目へのパスを指定します。 ワイルドカード文字を使用できます。

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	True

-Recurse

このコマンドレットが再帰的なコピーを実行することを示します。

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ToSession

これは、 FileSystem プロバイダーが使用できる動的パラメーターです。

リモート・ファイルのコピー先の PSSession オブジェクトを指定します。 このパラメーターを使用すると、 Destination パラメーターはリモート コンピューター上のローカル パスを参照します。

詳細については、「 about_FileSystem_Provider」を参照してください。

Type:	PSSession
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

String

このコマンドレットへのパスを含む文字列をパイプできます。

出力

None

既定では、このコマンドレットは出力を返しません。

PSObject

PassThru パラメーターを使用すると、コピーしたアイテムを表すオブジェクトが返されます。

メモ

PowerShell には、 の次のエイリアスが Copy-Item含まれています。

• すべてのプラットフォーム:
  • copy
  • cpi
• Windows の場合:
  • cp

このコマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用できるプロバイダーを一覧表示するには、「」と入力します Get-PSProvider。 詳細については、「about_Providers」を参照してください。

関連リンク

• about_Providers
• Clear-Item
• Get-Item
• Get-PSProvider
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item