Name

Test-ZipFile

SYNOPSIS

Teste si un fichier est une archive au format PkZip.

SYNTAX

Test-ZipFile [-Path] <Object> [-Password <String>] [-isValid] [-Check] [-Repair] [<CommonParameters>]

Test-ZipFile [-Path] <Object> [-Password <String>] [-isValid] [-Check] [-Repair] [-Passthru] [<CommonParameters>]

DESCRIPTION

Teste si un fichier est une archive au format PkZip. Lors de ce test, il est également possible de vérifier si l'archive est valide et de tenter dans ce cas de la réparer.

Par défaut les erreurs simples sont déclenchées.

PARAMETERS

-Path <Object>

Nom du fichier de l'archive à tester.

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

-Password <String>

Mot de passe, nécessaire si l'archive est protégée par un mot de passe. Si vous devez tester une archive avec un mot de passe n'utilisez pas le paramètre -IsValid, car dans ce cas le résultat renvoyé sera toujours faux.

Utilisez uniquement le paramètre -Password et/ou le paramètre -Check. Si le password est faux le résultat renvoyé sera faux.

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

-isValid <SwitchParameter>

Indique si l'archive semble valide. Cette fonction peut donc renvoyer $true alors que le contenu de l'archive est erronée.

Si un fichier n'est pas une archive et que le paramètre -isValid est précisé, alors les erreurs simples ne sont pas générées.

Si vous devez tester une archive avec un mot de passe n'utilisez pas ce paramètre, mais le paramètre -Password et/ou le paramètre -Check.

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

-Check <SwitchParameter>

Vérifie si le catalogue de l'archive indiquée est correcte. Cette vérification est plus stricte que celle effectuée avec le paramètre -isValid.

Elle peut donc renvoyer $false bien que le fichier soit considéré comme une archive valide.

Si vous devez tester une archive avec un mot de passe utilisez ce paramètre avec ou sans le paramètre -Password.

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

-Repair <SwitchParameter>

Tente une réparation si l'archive est corrompue.

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

-Passthru <SwitchParameter>

Emet le nom du fichier de l'archive dans le pipeline. Si le paramètre -isValid est également précisé, alors les noms des fichiers considérés comme invalide ne seront pas émis dans le pipeline et aucune erreur simple ne sera déclenchée.

Ce comportement est similaire à un filtre, où seul les noms des fichiers valides seraient émis dans le pipeline. Les objets archive renvoyés n'étant pas verrouillés, soyez attentif à vos scénarios d'usage de ces objets.

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.Boolean

NOTES

EXAMPLES

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

PS C:\> "C:\Temp\*.*"|Compress-ZipFile "C:\Temp\Test.zip"
Test-Zipfile "C:\Temp\Test.zip"

La première ligne crée une archive au format Zip,

la seconde teste si le fichier est bien une archive au format PkZip.

Le résultat de l'exécution vaut $true.

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

PS C:\> "C:\Temp\*.*"|Compress-ZipFile "C:\Temp\Test.zip"
ConvertTo-Sfx  -path "C:\Temp\Test.zip" 
Test-Zipfile "C:\Temp\Test.exe"

La première ligne crée une archive au format Zip,

la seconde crée une archive auto extractible,

la troisième teste si le fichier est bien une archive au format PkZip.

On constate qu'une archive auto extractible est considérée comme étant une archive valide. Le résultat de l'exécution vaut $true.

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

PS C:\> Get-Service Winmgmt|Test-ZipFile

Le résultat de l'exécution vaut $false, car l'objet reçu, transformé en string, ne référence pas un fichier d'archive .ZIP.

RELATED LINKS

Last edited Mar 8, 2014 at 6:43 PM by LaurentDardenne, version 5

Comments

No comments yet.