Export-Csv
Převede objekty na řadu řetězců hodnot oddělených čárkami (CSV) a uloží tyto řetězce do souboru.
Syntax
Delimiter (Výchozí)
Export-Csv
[[-Path] <string>]
[[-Delimiter] <char>]
-InputObject <psobject>
[-LiteralPath <string>]
[-Force]
[-NoClobber]
[-Encoding <string>]
[-Append]
[-NoTypeInformation]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UseCulture
Export-Csv
[[-Path] <string>]
-InputObject <psobject>
[-LiteralPath <string>]
[-Force]
[-NoClobber]
[-Encoding <string>]
[-Append]
[-UseCulture]
[-NoTypeInformation]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Export-CSV vytvoří soubor CSV objektů, které odešlete. Každý objekt je řádek, který obsahuje čárkami oddělený seznam hodnot vlastností objektu. Pomocí rutiny Export-CSV můžete vytvářet tabulky a sdílet data s programy, které přijímají soubory CSV jako vstup.
Před odesláním do rutiny Export-CSV objekty neformátujte. Pokud Export-CSV obdrží formátované objekty, soubor CSV obsahuje vlastnosti formátu, nikoli vlastnosti objektu. Pokud chcete exportovat pouze vybrané vlastnosti objektu, použijte rutinu Select-Object.
Příklady
Příklad 1: Export vlastností procesu do souboru CSV
Tento příklad vybere Process objekty s konkrétními vlastnostmi, exportuje objekty do souboru CSV.
Get-Process -Name WmiPrvSE | Select-Object -Property BasePriority,Id,SessionId,WorkingSet |
Export-Csv -Path .\WmiData.csv -NoTypeInformation
Import-Csv -Path .\WmiData.csv
BasePriority Id SessionId WorkingSet
------------ -- --------- ----------
8 976 0 20267008
8 2292 0 36786176
8 3816 0 30351360
8 8604 0 15011840
8 10008 0 8830976
8 11764 0 14237696
8 54632 0 9502720
Rutina Get-Process získá objekty Process. Parametr Name filtruje výstup tak, aby zahrnoval pouze objekty procesu WmiPrvSE. Objekty procesu se odesílají do kanálu do rutiny Select-Object.
Select-Object pomocí parametru vlastnosti vybere podmnožinu vlastností objektu procesu. Objekty procesu se odesílají do kanálu do rutiny Export-Csv.
Export-Csv převede objekty procesu na řadu řetězců CSV. Parametr Path určuje, že soubor WmiData.csv se uloží do aktuálního adresáře. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6. Rutina Import-Csv používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Příklad 2: Export procesů do souboru s oddělovači
Tento příklad získá Process objekty a exportuje objekty do souboru CSV.
Get-Process | Export-Csv -Path .\Processes.csv -NoTypeInformation
Get-Content -Path .\Processes.csv
"Name","SI","Handles","VM","WS","PM","NPM","Path","Parent","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","511","2203597099008","35364864","21979136","30048", ...
Rutina Get-Process získá objekty Process. Objekty procesu se odesílají do kanálu do rutiny Export-Csv.
Export-Csv převede objekty procesu na řadu řetězců CSV.
Parametr Path určuje, že soubor Processes.csv se uloží do aktuálního adresáře. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6. Rutina Get-Content používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Příklad 3: Export procesů do souboru s oddělovači středníkem
Tento příklad získá Process objekty a exportuje objekty do souboru s oddělovačem středníku.
Get-Process | Export-Csv -Path .\Processes.csv -Delimiter ';' -NoTypeInformation
Get-Content -Path .\Processes.csv
"Name";"SI";"Handles";"VM";"WS";"PM";"NPM";"Path";"Parent";"Company";"CPU";"FileVersion"; ...
"ApplicationFrameHost";"4";"509";"2203595321344";"34807808";"21770240";"29504"; ...
Rutina Get-Process získá objekty Process. Objekty procesu se odesílají do kanálu do rutiny Export-Csv.
Export-Csv převede objekty procesu na řadu řetězců CSV.
Parametr Path určuje, že soubor Processes.csv se uloží do aktuálního adresáře. Parametr oddělovače určuje středník pro oddělení řetězcových hodnot. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6. Rutina Get-Content používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Příklad 4: Export procesů pomocí oddělovače seznamu aktuální jazykové verze
Tento příklad získá Process objekty a exportuje objekty do souboru. Oddělovač je oddělovač seznamu aktuální jazykové verze.
(Get-Culture).TextInfo.ListSeparator
Get-Process | Export-Csv -Path .\Processes.csv -UseCulture -NoTypeInformation
Get-Content -Path .\Processes.csv
"Name","SI","Handles","VM","WS","PM","NPM","Path","Parent","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","511","2203597099008","35364864","21979136","30048", ...
Rutina Get-Culture používá vnořené vlastnosti TextInfo a ListSeparator a zobrazí výchozí oddělovač seznamu aktuální jazykové verze. Rutina Get-Process získá objekty Process.
Objekty procesu se odesílají do kanálu do rutiny Export-Csv.
Export-Csv převede objekty procesu na řadu řetězců CSV. Parametr Path určuje, že soubor Processes.csv se uloží do aktuálního adresáře. Parametr UseCulture používá jako oddělovač výchozího seznamu aktuální jazykové verze. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6. Rutina Get-Content používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Příklad 5: Export procesů s informacemi o typu
Tento příklad vysvětluje, jak do souboru CSV zahrnout informace #TYPE záhlaví. Hlavička #TYPE je výchozí ve verzích před PowerShellem 6.0.
Get-Process | Export-Csv -Path .\Processes.csv
Get-Content -Path .\Processes.csv
#TYPE System.Diagnostics.Process
"Name","SI","Handles","VM","WS","PM","NPM","Path","Company","CPU","FileVersion", ...
"ApplicationFrameHost","4","507","2203595001856","35139584","20934656","29504", ...
Rutina Get-Process získá objekty Process. Objekty procesu se odesílají do kanálu do rutiny Export-Csv.
Export-Csv převede objekty procesu na řadu řetězců CSV.
Parametr Path určuje, že soubor Processes.csv se uloží do aktuálního adresáře. Rutina Get-Content používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Příklad 6: Export a připojení objektů do souboru CSV
Tento příklad popisuje, jak exportovat objekty do souboru CSV a pomocí parametru Připojit přidat objekty do existujícího souboru.
$AppService = (Get-Service -DisplayName *Application* | Select-Object -Property DisplayName, Status)
$AppService | Export-Csv -Path .\Services.Csv -NoTypeInformation
Get-Content -Path .\Services.Csv
$WinService = (Get-Service -DisplayName *Windows* | Select-Object -Property DisplayName, Status)
$WinService | Export-Csv -Path ./Services.csv -NoTypeInformation -Append
Get-Content -Path .\Services.Csv
"DisplayName","Status"
"Application Layer Gateway Service","Stopped"
"Application Identity","Running"
"Windows Audio Endpoint Builder","Running"
"Windows Audio","Running"
"Windows Event Log","Running"
Rutina Get-Service získá objekty služby. Parametr DisplayName vrací služby, které obsahují slovo Aplikace. Objekty služby se odesílají do kanálu do rutiny Select-Object.
Select-Object používá parametr vlastnosti k určení vlastností DisplayName a Status. Proměnná $AppService ukládá objekty.
Objekty $AppService se odesílají do Export-Csv rutiny.
Export-Csv převede objekty služby na řadu řetězců CSV. Parametr Path určuje, že soubor Services.csv se uloží do aktuálního adresáře. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6. Rutina Get-Content používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Rutiny Get-Service a Select-Object se opakují pro služby, které obsahují slovo Windows. Proměnná $WinService ukládá objekty služby. Rutina Export-Csv pomocí parametru Append určuje, že $WinService se objekty přidají do existujícího souboru Services.csv. Rutina Get-Content se opakuje, aby se zobrazil aktualizovaný soubor, který obsahuje připojená data.
Příklad 7: Formátování rutiny v kanálu vytváří neočekávané výsledky
Tento příklad ukazuje, proč není důležité v kanálu používat rutinu formátu. Při přijetí neočekávaného výstupu vyřešte syntaxi kanálu.
Get-Date | Select-Object -Property DateTime, Day, DayOfWeek, DayOfYear |
Export-Csv -Path .\DateTime.csv -NoTypeInformation
Get-Content -Path .\DateTime.csv
"DateTime","Day","DayOfWeek","DayOfYear"
"Wednesday, January 2, 2019 14:59:34","2","Wednesday","2"
Get-Date | Format-Table -Property DateTime, Day, DayOfWeek, DayOfYear |
Export-Csv -Path .\FTDateTime.csv -NoTypeInformation
Get-Content -Path .\FTDateTime.csv
"ClassId2e4f51ef21dd47e99d3c952918aff9cd","pageHeaderEntry","pageFooterEntry","autosizeInfo", ...
"033ecb2bc07a4d43b5ef94ed5a35d280",,,,"Microsoft.PowerShell.Commands.Internal.Format. ...
"9e210fe47d09416682b841769c78b8a3",,,,,
"27c87ef9bbda4f709f6b4002fa4af63c",,,,,
"4ec4f0187cb04f4cb6973460dfe252df",,,,,
"cf522b78d86c486691226b40aa69e95c",,,,,
Rutina Get-Date získá objekt DateTime. Objekt se odešle do kanálu do rutiny Select-Object.
Select-Object pomocí parametru Vlastnost vybere podmnožinu vlastností objektu. Objekt se odešle do kanálu do rutiny Export-Csv.
Export-Csv převede objekt do formátu CSV. Parametr Path určuje, že soubor DateTime.csv se uloží do aktuálního adresáře. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6. Rutina Get-Content používá parametr Path k zobrazení souboru CSV umístěného v aktuálním adresáři.
Když se rutina Format-Table použije v kanálu k výběru vlastností, obdrží se neočekávané výsledky.
Format-Table odesílá objekty formátu tabulky do kanálu do rutiny Export-Csv místo objektu DateTime.
Export-Csv převede objekty formátu tabulky na řadu řetězců CSV. Rutina Get-Content zobrazí soubor CSV, který obsahuje objekty formátu tabulky.
Příklad 8: Použití parametru Force k přepsání souborů jen pro čtení
Tento příklad vytvoří prázdný soubor jen pro čtení a použije k aktualizaci souboru parametr Force.
New-Item -Path .\ReadOnly.csv -ItemType File
Set-ItemProperty -Path .\ReadOnly.csv -Name IsReadOnly -Value $true
Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation
Export-Csv : Access to the path 'C:\ReadOnly.csv' is denied.
At line:1 char:15
+ Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation
+ ~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : OpenError: (:) [Export-Csv], UnauthorizedAccessException
+ FullyQualifiedErrorId : FileOpenFailure,Microsoft.PowerShell.Commands.ExportCsvCommand
Get-Process | Export-Csv -Path .\ReadOnly.csv -NoTypeInformation -Force
Get-Content -Path .\ReadOnly.csv
"Name";"SI";"Handles";"VM";"WS";"PM";"NPM";"Path";"Parent";"Company";"CPU";"FileVersion"; ...
"ApplicationFrameHost";"4";"509";"2203595321344";"34807808";"21770240";"29504"; ...
Rutina New-Item používá parametry Path a ItemType k vytvoření souboru ReadOnly.csv v aktuálním adresáři. Rutina Set-ItemProperty používá parametry Name a Value k změně vlastnosti IsReadOnly souboru na true. Rutina Get-Process získá objekty Process. Objekty procesu se odesílají do kanálu do rutiny Export-Csv.
Export-Csv převede objekty procesu na řadu řetězců CSV. Parametr Path určuje, že soubor ReadOnly.csv se uloží do aktuálního adresáře. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6. Výstup ukazuje, že soubor není zapsán, protože přístup byl odepřen.
Do rutiny se přidá parametr Export-Csv, který export do souboru zapíše. Rutina Get-Content používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Příklad 9: Použití parametru Force s připojením
Tento příklad ukazuje, jak použít parametry Force a Append. Při kombinování těchto parametrů lze neshodované vlastnosti objektu zapsat do souboru CSV.
$Content = [PSCustomObject]@{Name = 'PowerShell Core'; Version = '6.0'}
$Content | Export-Csv -Path .\ParmFile.csv -NoTypeInformation
$AdditionalContent = [PSCustomObject]@{Name = 'Windows PowerShell'; Edition = 'Desktop'}
$AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append
Export-Csv : Cannot append CSV content to the following file: ParmFile.csv.
The appended object does not have a property that corresponds to the following column:
Version. To continue with mismatched properties, add the -Force parameter, and then retry
the command.
At line:1 char:22
+ $AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidData: (Version:String) [Export-Csv], InvalidOperationException
+ FullyQualifiedErrorId : CannotAppendCsvWithMismatchedPropertyNames,Microsoft.PowerShell. ...
$AdditionalContent | Export-Csv -Path .\ParmFile.csv -NoTypeInformation -Append -Force
Import-Csv -Path .\ParmFile.csv
Name Version
---- -------
PowerShell Core 6.0
Windows PowerShell
Výraz vytvoří PSCustomObject s vlastnostmi Name a Version. Hodnoty jsou uloženy v proměnné $Content. Proměnná $Content se odešle do kanálu do rutiny Export-Csv.
Export-Csv použije parametr Path a uloží soubor ParmFile.csv do aktuálního adresáře. Parametr NoTypeInformation odebere hlavičku informací #TYPE z výstupu CSV a není vyžadována v PowerShellu 6.
Jiný výraz vytvoří PSCustomObject s vlastnostmi Name a Edition. Hodnoty jsou uloženy v proměnné $AdditionalContent. Proměnná $AdditionalContent se odešle do kanálu do rutiny Export-Csv. Parametr Append slouží k přidání dat do souboru. Připojení selže, protože došlo k neshodě názvů vlastností mezi verze a Edition.
Rutina Export-CsvVynutit parametr slouží k vynucení exportu pro zápis do souboru. Vlastnost Edition se zahodí. Rutina Import-Csv používá parametr Path k zobrazení souboru umístěného v aktuálním adresáři.
Parametry
-Append
Tento parametr použijte, aby Export-CSV přidal výstup CSV na konec zadaného souboru. Bez tohoto parametru Export-CSV nahradí obsah souboru bez upozornění.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Delimiter
Určuje oddělovač pro oddělení hodnot vlastností. Výchozí hodnota je čárka (,). Zadejte znak, například dvojtečku (:). Chcete-li zadat středník (;), uzavřete ho do uvozovek.
Vlastnosti parametru
| Typ: | Char |
| Default value: | comma (,) |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Delimiter
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Encoding
Určuje typ kódování cílového souboru. Výchozí hodnota je ASCII.
Přijatelné hodnoty pro tento parametr jsou následující:
- ASCII používá znakovou sadu ASCII (7bitová).
- BigEndianUnicode používá UTF-16 s pořadím velkých bajtů.
- Výchozí Používá kódování odpovídající aktivní znakové stránce systému (obvykle ANSI).
- OEM Používá kódování odpovídající aktuální znakové stránce OEM systému.
- Unicode používá UTF-16 s minimálním pořadím bajtů.
- UTF7 používá UTF-7.
- UTF8 používá UTF-8.
- UTF32 používá UTF-32 s malým pořadím bajtů.
Vlastnosti parametru
| Typ: | String |
| Default value: | ASCII |
| Přípustné hodnoty: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Tento parametr umožňuje Export-Csv přepsat soubory atributem Jen pro čtení.
Při kombinaci parametrů Force a Append lze do souboru CSV zapsat objekty, které obsahují neodpovídající vlastnosti. Do souboru se zapisují pouze vlastnosti, které odpovídají. Neodpovídající vlastnosti se zahodí.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje objekty, které se mají exportovat jako řetězce CSV. Zadejte proměnnou obsahující objekty nebo zadejte příkaz nebo výraz, který objekty získá. Objekty lze také pipetovat do Export-CSV.
Vlastnosti parametru
| Typ: | PSObject |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cestu k výstupnímu souboru CSV. Na rozdíl od Pathse hodnota parametru LiteralPath používá přesně tak, jak je zadán. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje řídicí znaky, použijte jednoduché uvozovky. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-NoClobber
Tento parametr použijte, aby Export-CSV nepřepsal existující soubor. Ve výchozím nastavení, pokud soubor existuje v zadané cestě, Export-CSV přepíše soubor bez upozornění.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | NoOverwrite |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-NoTypeInformation
Odebere ze výstupu hlavičku #TYPE informací. Tento parametr se stal výchozím nastavením v PowerShellu 6.0 a je součástí zpětné kompatibility.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | NTI |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Povinný parametr, který určuje umístění pro uložení výstupního souboru CSV.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-UseCulture
Použije oddělovač seznamu pro aktuální kulturu jako oddělovač položek. K vyhledání oddělovače seznamu pro kulturu použijte následující příkaz: (Get-Culture).TextInfo.ListSeparator.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
UseCulture
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Zabrání zpracování nebo provedení změn rutiny. Výstup ukazuje, co by se stalo, kdyby byla rutina spuštěna.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
PSObject
Libovolný objekt s adaptérem ETS (Extended Type System) můžete předat do Export-CSV.
Výstupy
String
Seznam CSV se odešle do souboru určeného v parametru Path.
Poznámky
Rutina Export-CSV převede objekty, které odešlete, na řadu řetězců CSV a uloží je do zadaného textového souboru. Pomocí Export-CSV můžete ukládat objekty do souboru CSV a pak pomocí rutiny Import-Csv vytvářet objekty ze souboru CSV.
V souboru CSV je každý objekt reprezentován čárkami odděleným seznamem hodnot vlastností objektu. Hodnoty vlastností jsou převedeny na řetězce pomocí ToString() metoda. Řetězce jsou reprezentovány názvem hodnoty vlastnosti. 'Export-CSV neexportuje metody objektu.
Řetězce CSV jsou výstupem následujícím způsobem:
- Ve výchozím nastavení první řetězec obsahuje hlavičku #TYPE informací následovanou plně kvalifikovaným názvem typu objektu. Například #TYPE System.Diagnostics.Process.
- Pokud NoTypeInformation je použit první řetězec obsahuje záhlaví sloupců. Záhlaví obsahují názvy vlastností prvního objektu jako seznam oddělený čárkami.
- Zbývající řetězce obsahují čárkami oddělené seznamy hodnot vlastností každého objektu.
Když do Export-CSVodešlete více objektů, Export-CSV soubor uspořádá na základě vlastností prvního objektu, který odešlete. Pokud zbývající objekty nemají jednu ze zadaných vlastností, hodnota vlastnosti tohoto objektu je null, jak je reprezentováno dvěma po sobě jdoucími čárkami. Pokud zbývající objekty mají další vlastnosti, tyto hodnoty vlastností nejsou zahrnuty do souboru.
Rutinu Import-Csv můžete použít k opětovnému vytvoření objektů z řetězců CSV v souborech. Výsledné objekty jsou verze CSV původních objektů, které se skládají z řetězcových reprezentací hodnot vlastností a žádné metody.
Rutiny ConvertTo-Csv a ConvertFrom-Csv převádějí objekty na řetězce CSV a z řetězců CSV.
Export-CSV je stejný jako ConvertTo-CSVs tím rozdílem, že ukládá řetězce CSV do souboru.