Export-Clixml

Reference

Modul:: Microsoft.PowerShell.Utility

Vytvoří reprezentaci objektu nebo objektů založených na jazyce XML a uloží ho do souboru.

Syntaxe

Export-Clixml
      [-Path] <String>
      -InputObject <PSObject>
      [-Depth <Int32>]
      [-Force]
      [-NoClobber]
      [-Encoding <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Export-Clixml
      -LiteralPath <String>
      -InputObject <PSObject>
      [-Depth <Int32>]
      [-Force]
      [-NoClobber]
      [-Encoding <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Export-Clixml serializovala objekt do reprezentace založené na jazyce XML (Common Language Infrastructure) uloží do souboru. Potom můžete pomocí rutiny Import-Clixml znovu vytvořit uložený objekt na základě obsahu tohoto souboru. Další informace o rozhraní příkazového řádku najdete v tématu Nezávislost jazyka.

Tato rutina je podobná s ConvertTo-Xmltím rozdílem, že Export-Clixml ukládá výsledný kód XML do souboru. ConvertTo-XML vrátí kód XML, abyste ho mohli dál zpracovávat v PowerShellu.

Cenným využitím počítačů s Windows je bezpečné exportování přihlašovacích Export-Clixml údajů a zabezpečení řetězců jako XML. Příklad najdete v příkladu 3.

Příklady

Příklad 1: Export řetězce do souboru XML

Tento příklad vytvoří soubor XML, který se uloží v aktuálním adresáři, reprezentace řetězce Toto je test.

"This is a test" | Export-Clixml -Path .\sample.xml

Řetězec This is a test se odešle do kanálu. Export-Clixml pomocí parametru Path vytvoří soubor XML pojmenovaný sample.xml v aktuálním adresáři.

Příklad 2: Export objektu do souboru XML

Tento příklad ukazuje, jak exportovat objekt do souboru XML a pak vytvořit objekt importem XML ze souboru.

Get-Acl C:\test.txt | Export-Clixml -Path .\FileACL.xml
$fileacl = Import-Clixml -Path .\FileACL.xml

Rutina Get-Acl získá popisovač Test.txt zabezpečení souboru. Odešle objekt dolů kanálu, aby předal popisovač zabezpečení do Export-Clixml. Reprezentace objektu založená na jazyce XML je uložena v souboru s názvem FileACL.xml.

Rutina Import-Clixml vytvoří objekt z XML v FileACL.xml souboru. Pak uloží objekt do $fileacl proměnné.

Příklad 3: Šifrování exportovaného objektu přihlašovacích údajů

V tomto příkladu můžete spuštěním rutiny spustit Get-Credential přihlašovací údaje, které jste uložili do $Credential proměnné, a uložit Export-Clixml přihlašovací údaje na disk.

Důležité

Export-Clixml Exportuje pouze šifrované přihlašovací údaje ve Windows. V operačních systémech jiných než Windows, jako je macOS a Linux, se přihlašovací údaje exportují jako prostý text uložený jako pole znaků Unicode. To poskytuje určité obfuskace, ale neposkytuje šifrování.

$Credxmlpath = Join-Path (Split-Path $Profile) TestScript.ps1.credential
$Credential | Export-Clixml $Credxmlpath
$Credxmlpath = Join-Path (Split-Path $Profile) TestScript.ps1.credential
$Credential = Import-Clixml $Credxmlpath

Rutina Export-Clixml šifruje objekty přihlašovacích údajů pomocí rozhraní API služby Windows Data Protection. Šifrování zajišťuje, že obsah objektu přihlašovacích údajů může dešifrovat pouze váš uživatelský účet na tomto počítači. Exportovaný CLIXML soubor nejde použít na jiném počítači nebo jiném uživateli.

V příkladu je soubor, ve kterém jsou uloženy přihlašovací údaje, reprezentována TestScript.ps1.credential. Nahraďte TestScript názvem skriptu, kterým načítáte přihlašovací údaje.

Objekt přihlašovacích údajů odešlete do kanálu Export-Clixmla uložíte ho do cesty, $Credxmlpathkterou jste zadali v prvním příkazu.

Pokud chcete přihlašovací údaje do skriptu importovat automaticky, spusťte poslední dva příkazy. Spusťte Import-Clixml import zabezpečeného objektu přihlašovacích údajů do skriptu. Tento import eliminuje riziko vystavení hesel ve formátu prostého textu ve vašem skriptu.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Depth

Určuje, kolik úrovní obsažených objektů je součástí reprezentace XML. Výchozí hodnota je 2.

Výchozí hodnotu lze přepsat pro typ objektu v souborech Types.ps1xml . Další informace najdete v tématu about_Types.ps1xml.

Typ:	Int32
Position:	Named
Default value:	2
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Encoding

Určuje typ kódování cílového souboru. Výchozí hodnota je Unicode.

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ů.
Default 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 minimálním pořadím bajtů.

Typ:	String
Přípustné hodnoty:	ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Position:	Named
Default value:	Unicode
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Způsobí, že rutina v případě potřeby vymaže atribut výstupního souboru jen pro čtení. Po dokončení příkazu se rutina pokusí obnovit atribut jen pro čtení.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Určuje objekt, který se má převést. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá. Objekty lze také pipetovat do Export-Clixml.

Typ:	PSObject
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-LiteralPath

Určuje cestu k souboru, kde bude uložena reprezentace XML objektu. Na rozdíl od cesty se hodnota parametru LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

Typ:	String
Aliasy:	PSPath
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NoClobber

Označuje, že rutina nepřepíše obsah existujícího souboru. Ve výchozím nastavení, pokud soubor existuje v zadané cestě, Export-Clixml přepíše soubor bez upozornění.

Typ:	SwitchParameter
Aliasy:	NoOverwrite
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Path

Určuje cestu k souboru, kde bude uložena reprezentace XML objektu.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

PSObject

Do této rutiny můžete vytvořit kanál libovolného objektu.

Výstupy

FileInfo

Tato rutina vrátí objekt FileInfo představující vytvořený soubor s uloženými daty.

Sdílet prostřednictvím

Export-Clixml

Syntaxe

Description

Příklady

Příklad 1: Export řetězce do souboru XML

Příklad 2: Export objektu do souboru XML

Příklad 3: Šifrování exportovaného objektu přihlašovacích údajů

Parametry

-Confirm

-Depth

-Encoding

-Force

-InputObject

-LiteralPath

-NoClobber

-Path

-WhatIf

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Export-Clixml

Syntaxe

Description

Příklady

Příklad 1: Export řetězce do souboru XML

Příklad 2: Export objektu do souboru XML

Příklad 3: Šifrování exportovaného objektu přihlašovacích údajů

Parametry

-Confirm

-Depth

-Encoding

-Force

-InputObject

-LiteralPath

-NoClobber

-Path

-WhatIf

Vstupy

Výstupy

Související odkazy

Další materiály