Delen via

Import-Clixml

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee importeert u een CLIXML-bestand en maakt u bijbehorende objecten in PowerShell.

Syntaxis

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

Description

Met de Import-Clixml cmdlet wordt een XML-bestand (Common Language Infrastructure) geïmporteerd met gegevens die Microsoft .NET Framework-objecten vertegenwoordigen en de PowerShell-objecten worden gemaakt. Zie Taalafhankelijkheidvoor meer informatie over CLI.

Een waardevol gebruik van Import-Clixml op Windows-computers is het importeren van referenties en beveiligde tekenreeksen die zijn geëxporteerd als beveiligde XML met behulp van Export-Clixml. Zie voorbeeld 2 voor een voorbeeld.

Import-Clixml gebruikt de byte-order-mark (BOM) om de coderingsindeling van het bestand te detecteren. Als het bestand geen bom heeft, wordt ervan uitgegaan dat de codering UTF8 is.

Voorbeelden

Voorbeeld 1: Een geserialiseerd bestand importeren en een object opnieuw maken

In dit voorbeeld wordt de cmdlet Export-Clixml gebruikt om een geserialiseerde kopie van de procesgegevens op te slaan die worden geretourneerd door Get-Process. Import-Clixml de inhoud van het geserialiseerde bestand ophaalt en een object maakt dat is opgeslagen in de variabele $Processes.

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

Voorbeeld 2: Een beveiligd referentieobject importeren

In dit voorbeeld, op basis van een referentie die u hebt opgeslagen in de $Credential variabele door de Get-Credential cmdlet uit te voeren, kunt u de Export-Clixml cmdlet uitvoeren om de referentie op schijf op te slaan.

Belangrijk

Export-Clixml alleen versleutelde referenties exporteert in Windows. Op niet-Windows-besturingssystemen, zoals macOS en Linux, worden referenties geëxporteerd in tekst zonder opmaak.

$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

De Export-Clixml cmdlet versleutelt referentieobjecten met behulp van de Windows Data Protection-API. De versleuteling zorgt ervoor dat alleen uw gebruikersaccount de inhoud van het referentieobject kan ontsleutelen. Het geëxporteerde CLIXML-bestand kan niet worden gebruikt op een andere computer of door een andere gebruiker.

In het voorbeeld wordt het bestand waarin de referentie is opgeslagen, vertegenwoordigd door TestScript.ps1.credential. Vervang TestScript- door de naam van het script waarmee u de referentie laadt.

U verzendt het referentieobject omlaag in de pijplijn naar Export-Clixmlen slaat het op in het pad, $Credxmlpath, dat u hebt opgegeven in de eerste opdracht.

Als u de referentie automatisch in uw script wilt importeren, voert u de laatste twee opdrachten uit. Voer Import-Clixml uit om het beveiligde referentieobject in uw script te importeren. Met deze import wordt het risico van het weergeven van wachtwoorden zonder opmaak in uw script weggenomen.

Parameters

-First

Hiermee wordt alleen het opgegeven aantal objecten opgehaald. Voer het aantal objecten in dat moet worden opgehaald.

Type:UInt64
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IncludeTotalCount

Rapporteert het totale aantal objecten in de gegevensset, gevolgd door de geselecteerde objecten. Als de cmdlet het totale aantal niet kan bepalen, wordt Onbekend totaalaantal weergegeven. Het gehele getal heeft een eigenschap Nauwkeurigheid die de betrouwbaarheid van de totale tellingswaarde aangeeft. De waarde van Nauwkeurigheid varieert van 0.0 tot 1.0 waarbij 0.0 betekent dat de cmdlet de objecten niet kon tellen, 1.0 betekent dat het aantal exact is en een waarde tussen 0.0 en 1.0 een steeds betrouwbaardere schatting aangeeft.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u het pad naar de XML-bestanden. In tegenstelling tot pad, wordt de waarde van de parameter LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String[]
Aliassen:PSPath
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad naar de XML-bestanden.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Skip

Hiermee wordt het opgegeven aantal objecten genegeerd en worden vervolgens de resterende objecten opgehaald. Voer het aantal objecten in dat u wilt overslaan.

Type:UInt64
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar Import-Clixmlpijplijn maken.

Uitvoerwaarden

PSObject

Import-Clixml objecten retourneert die zijn gedeserialiseerd uit de opgeslagen XML-bestanden.

Notities

Wanneer u meerdere waarden voor een parameter opgeeft, gebruikt u komma's om de waarden te scheiden. Bijvoorbeeld <parameter-name> <value1>, <value2>.