Copy-Item

名前空間内のある場所から別の場所に項目をコピーします。

構文

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

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

説明

Copy-Item コマンドレットは名前空間内のある場所から別の場所に項目をコピーします。Copy-Item を実行しても、コピー対象の項目は削除されません。このコマンドレットがコピーできる項目は、使用可能な Windows PowerShell プロバイダーによって変わります。たとえば、FileSystem プロバイダーで使用した場合は、ファイルとディレクトリをコピーできます。Registry プロバイダーで使用した場合は、レジストリ キーとエントリをコピーできます。

パラメーター

-Container

コピー操作の際、コンテナー オブジェクトを保持します。

-Credential <PSCredential>

この処理を実行するアクセス許可を持つユーザー アカウントを指定します。既定値は現在のユーザーです。

"User01" や "Domain01\User01" のようなユーザー名を入力するか、Get-Credential コマンドレットで生成されるような PSCredential オブジェクトを入力します。ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。

このパラメーターは、Windows PowerShell でインストールされるプロバイダーではサポートされていません。

-Destination <string>

項目のコピー先のパスを指定します。

-Exclude <string[]>

指定した項目を除外します。ワイルドカードを使用できます。

-Filter <string>

プロバイダーの形式や言語でフィルターを指定します。このパラメーターの値は、Path パラメーターを修飾します。ワイルドカードを使用できるかどうかなど、フィルターの構文はプロバイダーによって異なります。フィルターは他のパラメーターよりも効率が良い方法です。これは、オブジェクトを取得した後に Windows PowerShell がオブジェクトをフィルターするのではなく、オブジェクトを取得する際にプロバイダーがフィルターを適用するためです。

-Force

読み取り専用のファイルやエイリアスへのコピーなど、設定しないとユーザーが変更できない項目をコマンドレットでコピーできるようにします。

-Include <string[]>

コマンドレットの処理対象とする項目を指定し、それ以外の項目は除外します。

-LiteralPath <string[]>

項目のパスを指定します。LiteralPath パラメーターの値は入力したとおりに使用されます。ワイルドカードとして解釈される文字はありません。パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。単一引用符で囲んだ文字はエスケープ シーケンスとして解釈されません。

-PassThru

コピーされた各項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。

-Path <string[]>

コピー対象の項目のパスを指定します。

-Recurse

再帰的なコピーを指定します。

-Confirm

コマンドを実行する前に確認メッセージを表示します。

-WhatIf

実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

-UseTransaction

コマンドを有効なトランザクションに含めます。このパラメーターは、トランザクションの進行中のみ有効です。詳細については、「about_Transactions」を参照してください。

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。詳細については、次を参照してください: about_Commonparameters.

入力と出力

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

注

Copy-Item は、他のシェルの cp コマンドや copy コマンドに似ています。

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

例 1

C:\PS>copy-item C:\Wabash\Logfiles\mar1604.log.txt -destination C:\Presentation

説明
-----------
このコマンドを実行すると、ファイル mar1604.log.txt が C:\Presentation ディレクトリにコピーされます。元のファイルは削除されません。

例 2

C:\PS>copy-item C:\Logfiles -destination C:\Drawings -recurse

説明
-----------
このコマンドを実行すると、Logfiles ディレクトリの内容全体が Drawings ディレクトリにコピーされます。コピー元のディレクトリのサブディレクトリにファイルが格納されている場合は、そのままのファイル ツリーを保ってサブディレクトリがコピーされます。Container パラメーターには既定で True が設定されます。これによりディレクトリ構造が保持されます。

例 3

C:\PS>copy-item C:\Logfiles -destination C:\Drawings\Logs -recurse

説明
-----------
このコマンドを実行すると、C:\Logfiles ディレクトリの内容が C:\Drawings\Logs ディレクトリにコピーされます。サブディレクトリ \Logs が存在していなければ作成されます。

関連項目

概念

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