Import-CSV

Import-CSV [[-Delimiter] <char>] [-Path] <string[]> [-Header <string[]>] [<CommonParameters>]

Import-CSV -UseCulture [-Path] <string[]> [-Header <string[]>] [<CommonParameters>]

C:\PS>get-process | export-csv processes.csv

C:\PS> $p = import-CSV processes.csv

C:\PS> $p | get-member

   TypeName: CSV:System.Diagnostics.Process

Name                       MemberType   Definition
----                       ----------   ----------
Equals                     Method       System.Boolean Equals(Object obj)
GetHashCode                Method       System.Int32 GetHashCode()
GetType                    Method       System.Type GetType()
ToString                   Method       System.String ToString()
BasePriority               NoteProperty System.String BasePriority=8
Company                    NoteProperty System.String Company=Microsoft Corporation
...

C:\PS> $p | out-gridview

説明
-----------
この例では、Microsoft .NET Framework オブジェクトの CSV ファイルをエクスポートし、そのファイルをインポートする方法を示しています。

最初のコマンドは、Get-Process コマンドレットを使用してローカル コンピューター上のプロセスを取得します。また、パイプライン演算子 (|) を使用してプロセス オブジェクトを Export-CSV コマンドレットに送ります。このコマンドレットは、プロセス オブジェクトを現在のディレクトリにある Processes.csv ファイルにエクスポートします。

2 番目のコマンドは、Import-CSV コマンドレットを使用してプロセスを Import-CSV ファイルにインポートします。次に、結果のプロセス オブジェクトを $p 変数に保存します。

3 番目のコマンドは、パイプライン演算子 (|) を使用して、インポートされたオブジェクトを Get-Member コマンドレットに対してパイプ処理します。結果は、オブジェクトが、Get-Process により返される System.Diagnostic.Process オブジェクトではなく、CSV:System.Diagnostic.Process オブジェクトであることを示しています。

また、書式設定ファイルにはプロセス オブジェクトの CSV バージョンのエントリの種類が存在しないため、このようなオブジェクトは、標準的なプロセス オブジェクトの書式設定方法と同じ方法では書式設定されません。

オブジェクトを表示するには、Format-Table、Format-List などの書式設定コマンドレットを使用するか、Out-GridView に対してオブジェクトをパイプ処理します。

C:\PS>get-process | export-csv processes.csv -Delimiter :

C:\PS> $p = import-csv processes.csv -Delimiter :

説明
-----------
この例は、Import-CSV の Delimiter パラメーターを使用する方法を示しています。この例では、区切り文字としてコロン (:) を使用するファイルにプロセスがエクスポートされています。

プロセスをインポートする場合、Import-CSV ファイルは Delimiter パラメーターを使用してファイルで使用される区切り文字を示します。

C:\PS>$p = import-csv processes.csv -UseCulture

C:\PS> (get-culture).textinfo.listseparator

,

説明
-----------
この例は、Import-CSV の UseCulture パラメーターを使用する方法を示しています。

最初のコマンドは、Processes.csv ファイル内のオブジェクトを $p 変数にインポートします。また、UseCulture パラメーターを使用して、現在のカルチャについて定義されている区切り記号を使用するように Import-CSV に指示します。

2 番目のコマンドは、現在のカルチャの区切り記号を表示します。また、Get-Culture コマンドレットを使用して現在のカルチャを取得します。さらに、ドット (.) メソッドを使用して現在のカルチャの TextInfo プロパティと TextInfo 内のオブジェクトの ListSeparator プロパティを取得します。この例では、このコマンドはコンマを返します。

C:\PS>start-job -scriptblock { get-process } | export-csv jobs.csv

C:\PS> $header = "MoreData","StatusMessage","Location","Command","State","Finished","InstanceId","SessionId","Name","ChildJobs","Output","Error","Progress","Verbose","Debug","Warning","StateChanged"

# Delete header from file
C:\PS> $a = (get-content jobs.csv)
C:\PS> $a = $a[0], $a[2..($a.count - 1)]
C:\PS> $a > jobs.csv

C:\PS> $j = import-csv jobs.csv -header $header

C:\PS> $j

MoreData      : True
StatusMessage :
Location      : localhost
Command       : get-process
State         : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : 135bdd25-40d6-4a20-bd68-05282a59abd6
SessionId     : 1
Name          : Job1
ChildJobs     : System.Collections.Generic.List`1[System.Management.Automation.Job]
Output        : System.Management.Automation.PSDataCollection`1[System.Management.Automation.PSObject]
Error         : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ErrorRecord]
Progress      : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ProgressRecord]
Verbose       : System.Management.Automation.PSDataCollection`1[System.String]
Debug         : System.Management.Automation.PSDataCollection`1[System.String]
Warning       : System.Management.Automation.PSDataCollection`1[System.String]
StateChanged  :

説明
-----------
この例は、Import-CSV の Header パラメーターを使用して、結果としてインポートされるオブジェクトのプロパティ名を変更する方法を示しています。

最初のコマンドは Start-Job コマンドレットを使用して、ローカル コンピューター上で Get-Process コマンドを実行するバックグラウンド ジョブを開始します。パイプライン演算子 (|) によって、結果のジョブ オブジェクトは Export-CSV コマンドレットに送られます。このコマンドレットはジョブ オブジェクトを CSV 形式に変換します。代入演算子 (=) によって、結果の CSV が Jobs.csv ファイルに保存されます。

2 番目のコマンドは、ヘッダーを $header 変数に保存します。既定のヘッダーとは異なり、このヘッダーは "HasMoreData" の代わりに "MoreData" を使用し、"JobStateInfo" の代わりに "State" を使用します。

次の 3 つのコマンドは、Jobs.csv ファイルから元のヘッダー (2 行目) を削除します。

6 番目のコマンドは Import-CSV コマンドレットを使用して Jobs.csv ファイルをインポートし、CSV 文字列をジョブ オブジェクトの CSV バージョンに変換します。このコマンドは、Header パラメーターを使用して代替ヘッダーを送ります。結果は $j 変数に保存されます。

7 番目のコマンドは、$j 変数のオブジェクトを表示します。コマンドの出力に示されるように、結果のオブジェクトには "MoreData" プロパティと "State" プロパティがあります。

C:\PS>".\processes.csv" | import-csv

説明
-----------
このコマンドは、Processes.csv ファイルからオブジェクトをインポートします。