Name

Expand-ZipEntry

SYNOPSIS

Extrait des entrées d'une archive compressée au format Zip.

SYNTAX

Expand-ZipEntry -ZipFile <ZipFile> [-Name] <String[]> [-ExtractAction <ExtractExistingFileAction>] [-Password <String>] [-Encoding <Encoding>] [-AsHashTable] [-Strict] [<CommonParameters>]

Expand-ZipEntry -ZipFile <ZipFile> [-Name] <String[]> [-ExtractAction <ExtractExistingFileAction>] [-Password <String>] [-Encoding <Encoding>] [-AsHashTable] [-Byte] [-Strict] [<CommonParameters>]

Expand-ZipEntry -ZipFile <ZipFile> [-Name] <String[]> [-ExtractAction <ExtractExistingFileAction>] [-Password <String>] [-Encoding <Encoding>] [-AsHashTable] [-XML] [-Strict] [<CommonParameters>]

DESCRIPTION

Extrait des entrées d'une archive compressée au format Zip. Les données extraites sont soit des données sérialisées, soit un tableau d'octets, soit une chaîne de caractère et ils permettent de reconstruire un objet.

Pour extraire des fichiers d'une archive utilisez Expand-ZipFile.

PARAMETERS

-ZipFile <ZipFile>

Objet contenant une archive Zip.

Required? True
Position? named
Default value  
Accept pipeline input? true (ByValue)
Accept wildcard characters? False

-Name <String[]>

Nom des entrées à extraire.

Required? True
Position? 1
Default value  
Accept pipeline input? true (ByValue)
Accept wildcard characters? False

-ExtractAction <ExtractExistingFileAction>

Précise le comportement à adopter lorsque des données sont déjà présentes dans le répertoire de destination.

Values : Throw, OverwriteSilently, DoNotOverwrite, InvokeExtractProgressEvent

Required? False
Position? named
Default value  
Accept pipeline input? false
Accept wildcard characters? False

-Password <String>

Précise le mot de passe nécessaire à l'extraction des entrées contenues dans une archive encryptée.

Required? False
Position? named
Default value  
Accept pipeline input? false
Accept wildcard characters? False

-Encoding <Encoding>

Type d'encodage de l'archive. Les valeurs possibles sont :

-ASCII           : encodage pour le jeu de caractères ASCII (7 bits).

-BigEndianUnicode : encodage pour le format UTF-16 qui utilise l'ordre d'octet avec primauté des octets de poids fort (big-endian).

-Default          : encodage pour la page de codes ANSI actuelle du système d'exploitation. -Unicode          : encodage pour le format UTF-16 avec primauté des octets de poids faible (little-endian).

-UTF32           : encodage pour le format UTF-32 avec primauté des octets de poids faible (little-endian).

-UTF7           : encodage pour le format UTF-7. -UTF8           : encodage pour le format UTF-8. . Pour une meilleure portabilité, l'utilisation de la valeur par défaut ('DefaultEncoding') est recommandé.

Required? False
Position? named
Default value  
Accept pipeline input? false
Accept wildcard characters? False

-AsHashTable <SwitchParameter>

Renvoi les entrées lues dans un objet de type hashtable. Les noms des entrées à extraire seront utilisées en tant que nom de clé.

Required? False
Position? named
Default value  
Accept pipeline input? false
Accept wildcard characters? False

-Strict <SwitchParameter>

Les erreurs déclenchent une exception au lieu d'être affichées.

Required? False
Position? named
Default value  
Accept pipeline input? false
Accept wildcard characters? False

-Byte <SwitchParameter>

L'entrée est renvoyée en tant que tableau d'octets.

Required? False
Position? named
Default value  
Accept pipeline input? false
Accept wildcard characters? False

-XML <SwitchParameter>

L'objet de type string est renvoyé dans le format XML.

Required? False
Position? named
Default value  
Accept pipeline input? false
Accept wildcard characters? False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable.

For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Xml.XmlDocument

NOTES

Cette fonction est couplée à la fonction nommée Add-ZipEntry

EXAMPLES

-------------- EXAMPLE 1 --------------

PS C:\> try {         
$ZipFile=Get-Zipfile -Path C:\Temp\Test.zip
[string]$Text=Get-Content C:\Temp\Test.ps1|Out-String
Add-ZipEntry -Object $Text -Name MyText -ZipFile $ZipFile
} finally {
$ZipFile.Close()
}
Remove-Variable Text
try {
$ZipFile=Get-Zipfile -Path C:\Temp\Test.zip 
[string]$Text =Expand-ZipEntry -Zip $ZipFile MyText   
} finally {
if ($ZipFile -ne $null )
{ $ZipFile.PSDispose() }
}

Ces instructions enregistrent dans un premier temps du texte dans une entrée nommée MyText, puis dans un second temps la relit et l'affecte à la variable $Text.

-------------- EXAMPLE 2 --------------

PS C:\> try {
$ZipFile=Get-Zipfile -Path C:\Temp\Test.zip         
ConvertTo-Clixml $PSVersionTable | Add-ZipEntry -Name 'PSVersiontable_clixml' -ZipFile $ZipFile
} finally {
$ZipFile.Close()
}

try {
$ZipFile=Get-Zipfile -Path C:\Temp\Test.zip 
$MaTableDeVersion=Expand-ZipEntry -Zip $ZipFile 'PSVersiontable_climxl'|ConvertFrom-Clixml   
} finally {
if ($ZipFile -ne $null )
{ $ZipFile.PSDispose() }
}
$MaTableDeVersion

Ces instructions enregistrent dans un premier temps un objet sérialisé dans une entrée nommée 'PSVersiontable_clixml', puis dans un second temps la relit et l'affecte à la variable $MaTableDeVersion.

-------------- EXAMPLE 3 --------------

PS C:\> try {         
$ZipFile=Get-Zipfile -Path C:\Temp\Test.zip 
[byte[]] $Array=@(1..20)
Add-ZipEntry -Object $Array -Name MyArray -ZipFile $ZipFile
} finally {
$ZipFile.Close()
}
Remove-Variable Array
try {
$ZipFile=Get-Zipfile -Path C:\Temp\Test.zip 
$Array=Expand-ZipEntry -Zip $ZipFile MyArray -Byte   
} finally {
if ($ZipFile -ne $null )
{ $ZipFile.PSDispose() }
}

Ces instructions enregistrent dans un premier temps un tableau d'octets dans une entrée nommée MyArray, puis dans un second temps la relit et l'affecte à la variable $Array.

RELATED LINKS

Last edited Mar 10, 2014 at 2:23 PM by LaurentDardenne, version 4

Comments

No comments yet.