Archive

  • Article

Synopsis

Développez ou supprimez le contenu d’un fichier archive (.zip).

Syntaxe

Archive [String] #ResourceName
{
    Destination = [string]
    Path = [string]
    [Checksum = [string]{ CreatedDate | ModifiedDate | SHA-1 | SHA-256 | SHA-512 }]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [Force = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [Validate = [bool]]
}

Description

La Archive ressource vous permet de gérer de manière idempotente le contenu développé d’un fichier d’archive (.zip). Il peut s’assurer que le contenu développé d’une archive est à jour ou supprimé d’un système.

Configuration requise

  • L’assembly de type System.IO.Compression doit être disponible sur l’ordinateur.
  • L’assembly de type System.IO.Compression.FileSystem doit être disponible sur l’ordinateur.

Propriétés de la clé

Destination

Spécifiez le chemin d’accès au dossier dans lequel le contenu développé doit être écrit ou supprimé.

Type: System.String

Chemin d’accès

Spécifiez le chemin d’accès au fichier archive.

Type: System.String

Propriétés facultatives

Somme de contrôle

Spécifiez la méthode de somme de contrôle à utiliser lors de la validation du contenu développé sur l’archive. Si vous spécifiez une valeur pour la somme de contrôleet la validation en tant que $false, la ressource lève une exception d’argument non valide.

Si vous spécifiez Validate as $true, la valeur par défaut pour la somme de contrôle est ModifiedDate.

Notes

L’utilisation de la somme de contrôleou de la validation implique l’autre. Même si vous pouvez spécifier Validate sans somme de contrôle, il est recommandé de spécifier les deux ensemble.

La méthode spécifiée détermine comment la ressource valide le contenu développé par rapport à l’archive :

  • Avec ModifiedDate, la ressource vérifie que la propriété LastWriteTime de chaque fichier développé correspond à la propriété LastWriteTime de ce fichier dans l’archive.
  • Avec CreatedDate, la ressource vérifie que la propriété CreationTime de chaque fichier développé correspond à la propriété CreationTime de ce fichier dans l’archive.
  • Avec SHA-1, SHA-256ou , ou SHA-512, la ressource utilise la méthode SHA spécifiée pour vérifier le hachage de chaque fichier développé par rapport au hachage de ce fichier dans l’archive.
Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

Informations d'identification

Spécifiez les informations d’identification d’un compte d’utilisateur avec des autorisations pour accéder au chemin d’accès et à la destination spécifiés si nécessaire.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Spécifiez si le contenu développé du fichier archive doit exister. Pour développer l’archive, spécifiez cette propriété en tant que Present. Pour supprimer le contenu développé de l’archive, spécifiez cette propriété en tant que Absent. La valeur par défaut est Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Force

Spécifiez s’il faut remplacer le contenu existant dans la destination. Lorsque Force est $false, les erreurs de ressource si un élément à la destination doit être remplacé. La valeur par défaut est $false.

Type: System.Boolean
Default Value: false

Valider

Spécifiez s’il faut vérifier le contenu développé par la méthode de somme de contrôle spécifiée. La valeur par défaut est $false.

Lorsque validate est $true et que le fichier à la destination ne correspond pas au fichier dans l’archive :

  • Si La vérification est et force, $falsePresent les erreurs de ressource avec un message indiquant que le fichier à la destination ne peut pas être remplacé.
  • Si La vérification est Present et force , $truela ressource remplace le fichier.
  • Si La vérification est Absent, la ressource ne supprime pas le fichier.
Type: System.Boolean
Default Value: false

Exemples