Sdílet prostřednictvím

Import-Clixml

  • Reference
Modul:
Microsoft.PowerShell.Utility

Importuje soubor CLIXML a vytvoří odpovídající objekty v PowerShellu.

Syntaxe

Import-Clixml
      [-Path] <String[]>
      [-IncludeTotalCount]
      [-Skip <UInt64>]
      [-First <UInt64>]
      [<CommonParameters>]
Import-Clixml
      -LiteralPath <String[]>
      [-IncludeTotalCount]
      [-Skip <UInt64>]
      [-First <UInt64>]
      [<CommonParameters>]

Description

Rutina Import-Clixml importuje soubor XML common language infrastructure (CLI) s daty, která představují objekty rozhraní Microsoft .NET Framework a vytvoří objekty PowerShellu. Další informace o rozhraní příkazového řádku najdete v tématu nezávislosti jazyka.

Cenným využitím Import-Clixml na počítačích s Windows je import přihlašovacích údajů a zabezpečených řetězců, které byly exportovány jako zabezpečený XML pomocí Export-Clixml. Příklad najdete v příkladu 2.

Import-Clixml pomocí značky bajtů (BOM) rozpozná formát kódování souboru. Pokud soubor neobsahuje boM, předpokládá se, že kódování je UTF8.

Příklady

Příklad 1: Import serializovaného souboru a opětovné vytvoření objektu

Tento příklad používá rutinu Export-Clixml k uložení serializované kopie informací o procesu vrácených Get-Process. Import-Clixml načte obsah serializovaného souboru a znovu vytvoří objekt uložený v proměnné $Processes.

Get-Process | Export-Clixml -Path .\pi.xml
$Processes = Import-Clixml -Path .\pi.xml

Příklad 2: Import zabezpečeného objektu přihlašovacích údajů

V tomto příkladu můžete spuštěním rutiny Export-Clixml uložit přihlašovací údaje uložené v proměnné $Credential spuštěním rutiny Get-CredentialExport-Clixml a uložit přihlašovací údaje na disk.

Důležitý

Export-Clixml exportuje jenom šifrované přihlašovací údaje ve Windows. V operačních systémech mimo Windows, jako jsou macOS a Linux, se přihlašovací údaje exportují ve formátu prostého textu.

$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 š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. Exportovaný soubor CLIXML nelze 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, do kterého načítáte přihlašovací údaje.

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

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

Parametry

-First

Získá pouze zadaný počet objektů. Zadejte počet objektů, které chcete získat.

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

-IncludeTotalCount

Zaznamenává celkový počet objektů v sadě dat následované vybranými objekty. Pokud rutina nemůže určit celkový počet, zobrazí Neznámý celkový počet. Celé číslo má vlastnost Přesnost, která označuje spolehlivost celkové hodnoty počtu. Hodnota přesnosti se pohybuje od 0.0 do 1.0, kde 0.0 znamená, že rutina nemohla spočítat objekty, 1.0 znamená, že počet je přesný a hodnota mezi 0.0 a 1.0 indikuje stále spolehlivější odhad.

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

-LiteralPath

Určuje cestu k souborům XML. Na rozdíl od Pathse hodnota parametru LiteralPath používá přesně tak, jak je zadaný. Žá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:True
Přijmout zástupné znaky:False

-Path

Určuje cestu k souborům XML.

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

-Skip

Přeskočí zadaný počet objektů a pak získá zbývající objekty. Zadejte počet objektů, které chcete přeskočit.

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

Vstupy

String

Můžete vytvořit kanál řetězce, který obsahuje cestu k Import-Clixml.

Výstupy

PSObject

Import-Clixml vrátí objekty, které byly deserializovány z uložených souborů XML.

Poznámky

Při zadávání více hodnot pro parametr použijte čárky k oddělení hodnot. Například <parameter-name> <value1>, <value2>.