Export-Clixml
Skapar en XML-baserad representation av ett objekt eller objekt och lagrar det i en fil.
Syntax
Export-Clixml
[-Path] <String>
-InputObject <PSObject>
[-Depth <Int32>]
[-Force]
[-NoClobber]
[-Encoding <Encoding>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Export-Clixml
-LiteralPath <String>
-InputObject <PSObject>
[-Depth <Int32>]
[-Force]
[-NoClobber]
[-Encoding <Encoding>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Cmdleten Export-Clixml skapar en XML-baserad representation av ett objekt eller objekt (Common Language Infrastructure) som lagras i en fil. Du kan sedan använda cmdleten Import-Clixml för att återskapa det sparade objektet baserat på innehållet i filen.
Mer information om CLI finns i Language independence.
Den här cmdleten liknar ConvertTo-Xml, förutom att Export-Clixml lagrar resulterande XML i en fil.
ConvertTo-XML returnerar XML-koden så att du kan fortsätta att bearbeta den i PowerShell.
En värdefull användning av Export-Clixml på Windows-datorer är att exportera autentiseringsuppgifter och skydda strängar på ett säkert sätt som XML. Ett exempel finns i Exempel 3.
Exempel
Exempel 1: Exportera en sträng till en XML-fil
Det här exemplet skapar en XML-fil som lagrar i den aktuella katalogen, en representation av strängen Det här är ett test.
"This is a test" | Export-Clixml -Path .\sample.xmlSträngen Det här är ett test skickas ned i pipelinen.
Export-Clixml använder parametern Path för att skapa en XML-fil med namnet sample.xml i den aktuella katalogen.
Exempel 2: Exportera ett objekt till en XML-fil
Det här exemplet visar hur du exporterar ett objekt till en XML-fil och sedan skapar ett objekt genom att importera XML från filen.
Get-Acl C:\test.txt | Export-Clixml -Path .\FileACL.xml
$fileacl = Import-Clixml -Path .\FileACL.xmlCmdleten Get-Acl hämtar säkerhetsbeskrivningen för Test.txt-filen. Det skickar objektet nedåt i pipelinen för att skicka säkerhetsbeskrivningen till Export-Clixml. Den XML-baserade representationen av objektet lagras i en fil med namnet FileACL.xml.
Cmdleten Import-Clixml skapar ett objekt från XML-koden i FileACL.xml-filen. Sedan sparas objektet i variabeln $fileacl.
Exempel 3: Kryptera ett exporterat autentiseringsobjekt i Windows
I det här exemplet kan du, med tanke på en autentiseringsuppgift som du har lagrat i $Credential-variabeln genom att köra Get-Credential-cmdleten, köra cmdleten Export-Clixml för att spara autentiseringsuppgifterna på disken.
Viktig
Export-Clixml exporterar endast krypterade autentiseringsuppgifter i Windows. I icke-Windows-operativsystem som macOS och Linux exporteras autentiseringsuppgifterna som en oformaterad text som lagras som en Unicode-teckenmatris. Detta ger viss fördunkling men tillhandahåller inte kryptering.
$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 $CredxmlpathCmdleten Export-Clixml krypterar autentiseringsobjekt med hjälp av Windows Data Protection API. Krypteringen säkerställer att endast ditt användarkonto på den datorn kan dekryptera innehållet i objektet för autentiseringsuppgifter.
Den exporterade CLIXML-filen kan inte användas på en annan dator eller av en annan användare.
I exemplet representeras filen där autentiseringsuppgifterna lagras av TestScript.ps1.credential. Ersätt TestScript- med namnet på skriptet som du läser in autentiseringsuppgifterna med.
Du skickar autentiseringsobjektet nedåt i pipelinen till Export-Clixmloch sparar det på sökvägen, $Credxmlpath, som du angav i det första kommandot.
Om du vill importera autentiseringsuppgifterna automatiskt till skriptet kör du de två sista kommandona. Kör Import-Clixml för att importera det skyddade autentiseringsobjektet till skriptet. Den här importen eliminerar risken för att exponera oformaterade lösenord i skriptet.
Exempel 4: Exportera ett autentiseringsobjekt i Linux eller macOS
I det här exemplet skapar vi en PSCredential- i variabeln $Credential med hjälp av cmdleten Get-Credential. Sedan använder vi Export-Clixml för att spara autentiseringsuppgifterna på disken.
Viktig
Export-Clixml exporterar endast krypterade autentiseringsuppgifter i Windows. I icke-Windows-operativsystem som macOS och Linux exporteras autentiseringsuppgifterna som en oformaterad text som lagras som en Unicode-teckenmatris. Detta ger viss fördunkling men tillhandahåller inte kryptering.
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
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 dUtdata från Get-Content i det här exemplet har trunkerats för att fokusera på autentiseringsinformationen i XML-filen. Observera att lösenordets oformaterade textvärde lagras i XML-filen som en Unicode-teckenmatris enligt Format-Hex. Så värdet är kodat men inte krypterat.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Depth
Anger hur många nivåer av inneslutna objekt som ingår i XML-representationen. Standardvärdet är 2.
Standardvärdet kan åsidosättas för objekttypen i Types.ps1xml-filerna. Mer information finns i about_Types.ps1xml.
| Typ: | Int32 |
| Position: | Named |
| Standardvärde: | 2 |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Encoding
Anger typen av kodning för målfilen. Standardvärdet är utf8NoBOM.
Godkända värden för den här parametern är följande:
-
ascii: Använder kodningen för ASCII-teckenuppsättningen (7-bitars). -
bigendianunicode: Kodar i UTF-16-format med hjälp av storslutsbyteordningen. -
oem: Använder standardkodning för MS-DOS- och konsolprogram. -
unicode: Kodar i UTF-16-format med hjälp av lite endiansk byteordning. -
utf7: Kodar i UTF-7-format. -
utf8: Kodar i UTF-8-format. -
utf8BOM: Kodar i UTF-8-format med Byte Order Mark (BOM) -
utf8NoBOM: Kodar i UTF-8-format utan Byte Order Mark (BOM) -
utf32: Kodar i UTF-32-format.
Från och med PowerShell 6.2 tillåter parametern Kodning även numeriska ID:n för registrerade kodsidor (till exempel -Encoding 1251) eller strängnamn för registrerade kodsidor (till exempel -Encoding "windows-1251"). Mer information finns i .NET-dokumentationen för Encoding.CodePage.
| Typ: | Encoding |
| Godkända värden: | ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | Named |
| Standardvärde: | UTF8NoBOM |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Gör att cmdleten rensar det skrivskyddade attributet för utdatafilen om det behövs. Cmdleten försöker återställa det skrivskyddade attributet när kommandot har slutförts.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-InputObject
Anger det objekt som ska konverteras. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten. Du kan också skicka objekt till Export-Clixml.
| Typ: | PSObject |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-LiteralPath
Anger sökvägen till filen där XML-representationen av objektet ska lagras. Till skillnad från Pathanvänds värdet för parametern LiteralPath exakt som den skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.
| Typ: | String |
| Alias: | PSPath, LP |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-NoClobber
Anger att cmdleten inte skriver över innehållet i en befintlig fil. Om en fil finns i den angivna sökvägen skriver Export-Clixml som standard över filen utan förvarning.
| Typ: | SwitchParameter |
| Alias: | NoOverwrite |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Path
Anger sökvägen till filen där XML-representationen av objektet ska lagras.
| Typ: | String |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
Du kan pipelines alla objekt till Export-Clixml.
Utdata
Export-Clixml skapar en fil som innehåller XML.