Import-Clixml
Importa un file CLIXML e crea oggetti corrispondenti in PowerShell.
Sintassi
ByPath (Impostazione predefinita)
Import-Clixml
[-Path] <String[]>
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>]
ByLiteralPath
Import-Clixml
-LiteralPath <String[]>
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>]
Descrizione
Il Import-Clixml cmdlet importa un file XML dell'interfaccia della riga di comando (Common Language Infrastructure) con i dati che rappresentano gli oggetti di Microsoft .NET Framework e crea gli oggetti PowerShell. Per altre informazioni sull'interfaccia della riga di comando, vedere indipendenza del linguaggio .
Un uso prezioso di Import-Clixml nei computer Windows consiste nell'importare credenziali e proteggere stringhe esportate come XML sicuro usando Export-Clixml. Per un esempio, vedere l'Esempio 2.
Import-Clixml usa il byte order-mark (BOM) per rilevare il formato di codifica del file. Se il file non ha bom, presuppone che la codifica sia UTF8.
Esempio
Esempio 1: Importare un file serializzato e ricreare un oggetto
In questo esempio viene utilizzato il cmdlet Export-Clixml per salvare una copia serializzata delle informazioni sul processo restituite da Get-Process.
Import-Clixml recupera il contenuto del file serializzato e ricrea un oggetto archiviato nella variabile $Processes.
Get-Process | Export-Clixml -Path .\pi.xml
$Processes = Import-Clixml -Path .\pi.xml
Esempio 2: Importare un oggetto credenziali sicure
In questo esempio, data una credenziale archiviata nella variabile $Credential eseguendo il cmdlet Get-Credential, è possibile eseguire il cmdlet Export-Clixml per salvare le credenziali su disco.
Importante
Export-Clixml esporta solo le credenziali crittografate in Windows. Nei sistemi operativi non Windows, ad esempio macOS e Linux, le credenziali vengono esportate in testo normale.
$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
Il cmdlet Export-Clixml crittografa gli oggetti credenziali usando l'API Protezione dati di Windows .
La crittografia garantisce che solo l'account utente possa decrittografare il contenuto dell'oggetto credenziale. Il file CLIXML esportato non può essere usato in un computer diverso o da un altro utente.
Nell'esempio il file in cui vengono archiviate le credenziali è rappresentato da TestScript.ps1.credential. Sostituire testScript con il nome dello script con cui si sta caricando la credenziale.
Inviare l'oggetto credenziale verso il basso nella pipeline per Export-Clixmle salvarlo nel percorso, $Credxmlpath, specificato nel primo comando.
Per importare automaticamente le credenziali nello script, eseguire i due comandi finali. Eseguire Import-Clixml per importare l'oggetto credenziale protetto nello script. Questa importazione elimina il rischio di esporre le password in testo normale nello script.
Parametri
-First
Ottiene solo il numero specificato di oggetti. Immettere il numero di processi da ottenere.
Proprietà dei parametri
| Tipo: | UInt64 |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IncludeTotalCount
Segnala il numero totale di oggetti nel set di dati seguito dagli oggetti selezionati. Se il cmdlet non riesce a determinare il conteggio totale, viene visualizzato Conteggio totale sconosciuto. L'intero ha una proprietà accuratezza che indica l'affidabilità del valore di conteggio totale. Il valore di accuratezza varia da 0.0 a 1.0 in cui 0.0 significa che il cmdlet non è riuscito a contare gli oggetti, 1.0 significa che il conteggio è esatto e un valore tra 0.0 e 1.0 indica una stima sempre più affidabile.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LiteralPath
Specifica il percorso dei file XML. A differenza di
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PSPath |
Set di parametri
ByLiteralPath
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Path
Specifica il percorso dei file XML.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByPath
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Skip
Ignora il numero specificato di oggetti e ottiene gli oggetti rimanenti. Immettere il numero di processi da ignorare.
Proprietà dei parametri
| Tipo: | UInt64 |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
String
È possibile eseguire la pipeline di una stringa che contiene un percorso per Import-Clixml.
Output
PSObject
Import-Clixml restituisce gli oggetti che sono stati deserializzati dai file XML archiviati.
Note
Quando si specificano più valori per un parametro, usare le virgole per separare i valori. Ad esempio: <parameter-name> <value1>, <value2>.