Copy-Item
項目をある場所から別の場所にコピーします。
構文
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>]Copy-Item
-LiteralPath <String[]>
[[-Destination] <String>]
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-FromSession <PSSession>]
[-ToSession <PSSession>]
[<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注意
パスに含まれる\*場合、サブディレクトリ ツリーを含むすべてのディレクトリのファイルの内容が、新しいコピー先ディレクトリにコピーされます。 次に例を示します。
Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse
例 4: 指定したディレクトリにファイルをコピーし、ファイルの名前を変更する
この例では、コマンドレットをCopy-Item使用して、ディレクトリから\\Server01\Shareディレクトリにスクリプトを\\Server12\ScriptArchiveコピーGet-Widget.ps1します。 コピー操作の一環として、このコマンドはアイテム名 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 コピーします。 スクリプト フォルダーにサブフォルダー内のファイルがある場合、それらのサブフォルダーはファイル ツリーはそのままコピーされます。
$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 パラメーターが使用されるため、スクリプト フォルダーがまだ存在しない場合は、この操作によってスクリプト フォルダーが作成されます。 スクリプト フォルダーにサブフォルダー内のファイルがある場合、それらのサブフォルダーはファイル ツリーはそのままコピーされます。
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\scripts" -FromSession $Session -Recurse例 12: フォルダー ツリーから現在のフォルダーにファイルを再帰的にコピーする
この例では、複数レベルのフォルダー構造から単一のフラット フォルダーにファイルをコピーする方法を示します。
最初の 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-Item コマンドレットには、 Container パラメーターが設定されています $false。 これにより、ソース フォルダーの内容はコピーされますが、フォルダー構造は保持されません。 同じ名前のファイルがコピー先フォルダーに上書きされていることに注意してください。
例 13: フィルターを使用して再帰なしでアイテムをコピーする
この例では、 Include パラメーターを使用してコピーする項目を選択した結果を示します。
この例では、コピーするファイルを含む次のフォルダー構造を使用します。
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
この例では、 Copy-ItemPath パラメーターと 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.txtInclude パラメーターは、一致ex*するすべてのアイテムをコピーするフォルダーのD:\temp\tree内容に適用されます。 再帰を行わないと、 D:\temp\out\examples フォルダーはコピーされますが、その内容はコピーされません。
例 15: フィルターを使用して再帰を含むアイテムをコピーする
この例では、 Include パラメーターを使用してコピーする項目を選択した結果を示します。
この例では、コピーするファイルを含む次のフォルダー構造を使用します。
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
この例では、 Copy-ItemPath パラメーターと 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.txtInclude パラメーターは、一致ex*するすべてのアイテムをコピーするフォルダーのD:\temp\tree内容に適用されます。 再帰では、 D:\temp\out\examples フォルダーがすべてのファイルとサブフォルダーと共にコピーされます。 コピーには、インクルード フィルターと一致 しない ファイルが含まれます。 使用 Copy-Itemする場合、フィルターは Path パラメーターで指定された最上位レベルにのみ適用されます。 その後、一致する項目に再帰が適用されます。
注意
Exclude パラメーターの動作は、この例で説明したのと同じですが、パターンに一致しないパスのみに操作を制限する点が異なります。
例 15: ワイルドカードで指定されたパスから再帰的にコピーするようにファイルを制限する
この例では、ワイルドカード一致パスから別のフォルダーに再帰的にコピーされるファイルを制限する方法を示します。 例 13 では、 Include パラメーターはワイルドカード指定 パスに対して解決されたパスでのみフィルター処理されるため、 Include パラメーターを使用して、フォルダーから再帰的にコピーされるファイルを制限できないことを示しています。 代わりに、コピーする項目を検索し、それらの項目Copy-Itemを渡すために使用Get-ChildItemできます。
この例では、コピーするファイルを含む次のフォルダー構造を使用します。
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\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-ItemFilter パラメーターはGet-ChildItem再帰中に検出された項目に適用されます。 これにより、項目を検索、フィルター処理、および再帰的にコピーできます。
パラメーター
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このコマンドレットがコピー操作中にコンテナー オブジェクトを保持することを示します。 既定では、 Container パラメーターは True に設定 されています。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
注意
このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。 別のユーザーを偽装したり、このコマンドレットの実行時に資格情報を昇格したりするには、 Invoke-Command を使用します。
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
新しい場所のパスを指定します。 既定値は、現在のディレクトリです。
コピーする項目の名前を変更するには、 Destination パラメーターの値に新しい名前を指定します。
| Type: | String |
| Position: | 1 |
| Default value: | Current directory |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
このコマンドレットの操作を制限するために、1 つ以上のパス要素またはパターン (例 "*.txt": ) を指定します。 このパラメーターの値は、最終的な結果ではなく、 Path パラメーターのワイルドカード一致結果に対してフィルター処理されます。 このパラメーターは、 Path が 1 つ以上のワイルドカードで指定されている場合にのみ有効です。 このパラメーターは Path パラメーターに対して解決されたパスのみをフィルター処理するため、 Recurse パラメーターを使用して子フォルダーを繰り返すときに検出された項目はフィルター処理されません。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
Path パラメーターを修飾するフィルターを指定します。 FileSystem プロバイダーは、フィルターの使用をサポートする唯一のインストール済み PowerShell プロバイダーです。 FileSystem フィルター言語の構文は、about_Wildcardsで確認できます。 プロバイダーは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにフィルターを適用するため、他のパラメーターよりも効率的です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
このコマンドレットが、読み取り専用のファイルまたはエイリアスをコピーするなど、変更できない項目をコピーすることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
リモート ファイルのコピー元の PSSession オブジェクトを指定します。 このパラメーターを使用すると、 Path パラメーターと LiteralPath パラメーターはリモート コンピューター上のローカル パスを参照します。
| Type: | PSSession |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このコマンドレットの操作を制限するために、1 つ以上のパス要素またはパターン (例 "*.txt": ) を指定します。 このパラメーターの値は、最終的な結果ではなく、 Path パラメーターのワイルドカード一致結果に対してフィルター処理されます。 このパラメーターは、 Path が 1 つ以上のワイルドカードで指定されている場合にのみ有効です。 このパラメーターは Path パラメーターに対して解決されたパスのみをフィルター処理するため、 Recurse パラメーターを使用して子フォルダーを繰り返すときに検出された項目はフィルター処理されません。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
1 つ以上の場所へのパスを指定します。 LiteralPath の値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、文字をエスケープ シーケンスとして解釈しないように PowerShell に指示します。
詳細については、「about_Quoting_Rules」 を参照してください。
| Type: | String[] |
| Aliases: | PSPath |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
文字列配列として、コピーする項目へのパスを指定します。 ワイルドカード文字を使用できます。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
このコマンドレットが再帰的なコピーを実行することを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
リモート・ファイルのコピー先の PSSession オブジェクトを指定します。 このパラメーターを使用すると、 Destination パラメーターはリモート コンピューター上のローカル パスを参照します。
| Type: | PSSession |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
アクティブなトランザクションのコマンドが含まれます。 このパラメーターは、トランザクションが進行中の場合のみ有効です。 詳細については、「about_Transactions」を参照してください。
| Type: | SwitchParameter |
| Aliases: | usetx |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
このコマンドレットへのパスを含む文字列をパイプ処理できます。
出力
None or an object representing the copied item
PassThru パラメーターを使用すると、コピーした項目を表すオブジェクトが返されます。 それ以外の場合、このコマンドレットは出力を生成しません。
メモ
このコマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「.」と入力します Get-PSProvider。 詳細については、「about_Providers」を参照してください。
関連リンク
フィードバック
フィードバックの送信と表示