Archivieren

  • Artikel

Übersicht

Erweitern oder Entfernen des Inhalts einer Archivdatei (.zip)

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]]
}

BESCHREIBUNG

Mit der Archive Ressource können Sie die erweiterten Inhalte einer Archivdatei (.zip) idempotently verwalten. Es kann sicherstellen, dass der erweiterte Inhalt eines Archivs auf dem neuesten Stand ist oder aus einem System entfernt wird.

Requirements (Anforderungen)

  • Die System.IO.Komprimierungstypassembly muss auf dem Computer verfügbar sein.
  • Die System.IO.Compression.FileSystem-Typassembly muss auf dem Computer verfügbar sein.

Schlüsseleigenschaften

Destination

Geben Sie den Pfad zum Ordner an, aus dem der erweiterte Inhalt geschrieben oder entfernt werden soll.

Type: System.String

Pfad

Geben Sie den Pfad zur Archivdatei an.

Type: System.String

Optionale Eigenschaften

Checksum

Geben Sie die Prüfsummenmethode an, die beim Überprüfen erweiterter Inhalte für das Archiv verwendet werden soll. Wenn Sie einen Wert für Prüfsumme und Überprüfung als "Überprüfen" $falseangeben, löst die Ressource eine ungültige Argument ausnahme aus.

Wenn Sie "Überprüfen als$true" angeben, lautet ModifiedDatedie Standardeinstellung für Prüfsumme .

Hinweis

Die Verwendung von Prüfsummen oder " Validieren " impliziert die andere. Obwohl Sie "Überprüfen ohne Prüfsumme" angeben können, empfiehlt es sich, beide zusammen anzugeben.

Die angegebene Methode bestimmt, wie die Ressource den erweiterten Inhalt im Archiv überprüft:

  • Mit ModifiedDateder Ressource wird überprüft, ob die LastWriteTime-Eigenschaft jeder erweiterten Datei mit der LastWriteTime-Eigenschaft dieser Datei im Archiv übereinstimmt.
  • Mit CreatedDateder Ressource wird überprüft, ob die CreationTime-Eigenschaft jeder erweiterten Datei mit der CreationTime-Eigenschaft dieser Datei im Archiv übereinstimmt.
  • Mit SHA-1, SHA-256oder SHA-512, verwendet die Ressource die angegebene SHA-Methode, um den Hash jeder erweiterten Datei gegen den Hash dieser Datei im Archiv zu überprüfen.
Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

Anmeldeinformationen

Geben Sie die Anmeldeinformationen eines Benutzerkontos mit Berechtigungen für den Zugriff auf den angegebenen Pfad und das angegebene Ziel an, falls erforderlich.

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

Ensure

Geben Sie an, ob der erweiterte Inhalt der Archivdatei vorhanden sein soll. Um das Archiv zu erweitern, geben Sie diese Eigenschaft als Present. Um den erweiterten Inhalt des Archivs zu entfernen, geben Sie diese Eigenschaft als Absent. Standardwert: Present.

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

Force

Geben Sie an, ob vorhandene Inhalte im Ziel überschrieben werden sollen. Wenn Erzwingen ist $false, wird die Ressource fehler, wenn ein Element am Ziel überschrieben werden muss. Standardwert: $false.

Type: System.Boolean
Default Value: false

Überprüfen

Geben Sie an, ob erweiterter Inhalt durch die angegebene Prüfsummenmethode überprüft werden soll. Standardwert: $false.

Wenn die Überprüfung erfolgt $true und die Datei am Ziel nicht mit der Datei im Archiv übereinstimmt:

  • Wenn sichergestellt ist Present und erzwingt ist $false, können die Ressourcenfehler mit einer Nachricht, die die Datei am Ziel nicht überschrieben werden kann.
  • Wenn sichergestellt ist Present und erzwingt$true, überschreibt die Ressource die Datei.
  • Wenn sichergestellt ist Absent, entfernt die Ressource die Datei nicht.
Type: System.Boolean
Default Value: false

Beispiele