Export-Clixml

Syntaxe

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

Export-Clixml
      [-Depth <Int32>]
      -LiteralPath <String>
      -InputObject <PSObject>
      [-Force]
      [-NoClobber]
      [-Encoding <Encoding>]
      [-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ů ve Windows

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.

$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.

Příklad 4: Export objektu přihlašovacích údajů v Linuxu nebo macOS

V tomto příkladu vytvoříme v proměnné psCredential pomocí rutinyGet-Credential.$Credential Pak přihlašovací údaje uložíme Export-Clixml na disk.

PS> $Credential = Get-Credential

PowerShell credential request
Enter your credentials.
User: User1
Password for user User1: ********

PS> $Credential | Export-Clixml ./cred2.xml
PS> Get-Content ./cred2.xml

...
    <Props>
      <S N="UserName">User1</S>
      <SS N="Password">700061007300730077006f0072006400</SS>
    </Props>
...

PS> 'password' | Format-Hex -Encoding unicode

   Label: String (System.String) <52D60C91>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 70 00 61 00 73 00 73 00 77 00 6F 00 72 00 64 00 p a s s w o r d

Výstup Get-Content v tomto příkladu byl zkrácen, aby se zaměřil na informace o přihlašovacích údajích v souboru XML. Všimněte si, že hodnota prostého textu hesla je uložena v souboru XML jako pole znaků Unicode, jak je prokázáno Format-Hex. Proto je hodnota zakódovaná, ale ne zašifrovaná.

Parametry

-Confirm

-Depth

-Encoding

-Force

-InputObject

-LiteralPath

-NoClobber

-Path

-WhatIf

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.

Související odkazy

• ConvertTo-Html
• ConvertTo-Xml
• Export-Csv
• Import-Clixml
• Join-Path
• Bezpečné ukládání přihlašovacích údajů na disk
• Předání přihlašovacích údajů starším systémům pomocí PowerShellu
• Windows.Security.Cryptography.DataProtection