Archiveren

Artikel
05/05/2023

Synopsis

De inhoud van een archiefbestand (.zip) uitvouwen of verwijderen.

Syntax

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

Met Archive de resource kunt u de uitgebreide inhoud van een archiefbestand (.zip) idempotent beheren. Het kan ervoor zorgen dat de uitgebreide inhoud van een archief up-to-date is of uit een systeem wordt verwijderd.

Vereisten

De assembly van het type System.IO.Compression moet beschikbaar zijn op de computer.
De assembly system.IO.Compression.FileSystem moet beschikbaar zijn op de computer.

Belangrijkste eigenschappen

Doel

Geef het pad naar de map op waarnaar de uitgevouwen inhoud moet worden geschreven of verwijderd.

Type: System.String

Pad

Geef het pad naar het archiefbestand op.

Type: System.String

Optionele eigenschappen

Controlesom

Geef de controlesommethode op die moet worden gebruikt bij het valideren van uitgebreide inhoud op basis van het archief. Als u een waarde opgeeft voor Checksum en Valideren als $false, genereert de resource een ongeldige argument-uitzondering.

Als u Valideren als $trueopgeeft, is ModifiedDatede standaardwaarde voor Checksum.

Notitie

Het gebruik van Checksum of Validate impliceert de andere. Hoewel u Valideren zonder Controlesom kunt opgeven, is het raadzaam om beide samen op te geven.

De opgegeven methode bepaalt hoe de resource de uitgevouwen inhoud valideert op het archief:

Met ModifiedDatede resource wordt gecontroleerd of de eigenschap LastWriteTime van elk uitgevouwen bestand overeenkomt met de eigenschap LastWriteTime van dat bestand in het archief.
Met CreatedDatede resource wordt gecontroleerd of de eigenschap CreationTime van elk uitgevouwen bestand overeenkomt met de eigenschap CreationTime van dat bestand in het archief.
Bij SHA-1, SHA-256of SHA-512, gebruikt de resource de opgegeven SHA-methode om de hash van elk uitgevouwen bestand te controleren op basis van de hash van dat bestand in het archief.

Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

Referentie

Geef indien nodig de referenties van een gebruikersaccount op met machtigingen voor toegang tot het opgegeven pad en het opgegeven doel.

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

Zorgen

Geef op of de uitgebreide inhoud van het archiefbestand moet bestaan. Als u het archief wilt uitvouwen, geeft u deze eigenschap op als Present. Als u de uitgebreide inhoud van het archief wilt verwijderen, geeft u deze eigenschap op als Absent. De standaardwaarde is Present.

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

Force

Geef op of bestaande inhoud in de bestemming moet worden overschreven. Als Force is $false, worden de resourcefouten als een item op de bestemming moet worden overschreven. De standaardwaarde is $false.

Type: System.Boolean
Default Value: false

Valideren

Geef op of u uitgebreide inhoud wilt controleren met de opgegeven controlesommethode. De standaardwaarde is $false.

Wanneer Valideren is $true en het bestand op de bestemming niet overeenkomt met het bestand in het archief:

Als Ensure is Present en Force is $false, worden de resourcefouten weergegeven met een bericht dat het bestand op de bestemming niet kan worden overschreven.
Als Ensure is Present en Force is $true, overschrijft de resource het bestand.
Als Ensure is Absent, wordt het bestand niet verwijderd door de resource.

Type: System.Boolean
Default Value: false

Delen via