Archiv

Článek
05/05/2023

Synopse

Rozbalte nebo odeberte obsah souboru archivu (.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]]
}

Description

Prostředek Archive umožňuje idempotentní správu rozšířeného obsahu souboru archivu (.zip). Může zajistit, aby byl rozbalený obsah archivu aktuální nebo odebraný ze systému.

Požadavky

Na počítači musí být k dispozici sestavení typu System.IO.Compression .
Na počítači musí být k dispozici sestavení typu System.IO.Compression.FileSystem .

Základní vlastnosti

Cíl

Zadejte cestu ke složce, do které se má rozbalený obsah zapsat nebo odebrat.

Type: System.String

Cesta

Zadejte cestu k archivačnímu souboru.

Type: System.String

Volitelné vlastnosti

Kontrolní součet

Zadejte metodu kontrolního součtu, která se má použít při ověřování rozšířeného obsahu v archivu. Pokud zadáte hodnotu kontrolního součtu a ověřit jako $false, prostředek vyvolá neplatnou výjimku argumentu.

Pokud zadáte funkci Ověřit jako $true, výchozí hodnota pro kontrolní součet je ModifiedDate.

Poznámka

Použití kontrolního součtu nebo ověření znamená druhou. I když můžete zadat možnost Ověřit bez kontrolního součtu, je osvědčeným postupem určit obojí dohromady.

Zadaná metoda určuje, jak prostředek ověří rozbalený obsah v archivu:

Prostředek ModifiedDatezkontroluje, že vlastnost LastWriteTime každého rozbalovaného souboru odpovídá vlastnosti LastWriteTime tohoto souboru v archivu.
Prostředek CreatedDatezkontroluje, že vlastnost CreationTime každého rozbaleného souboru odpovídá vlastnosti CreationTime tohoto souboru v archivu.
S SHA-1, SHA-256nebo SHA-512, prostředek používá zadanou metodu SHA k ověření hodnoty hash každého rozbaleného souboru proti hodnotě hash tohoto souboru v archivu.

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

Přihlašovací údaj

Zadejte přihlašovací údaje uživatelského účtu s oprávněními pro přístup k zadané cestě a cíli v případě potřeby.

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

Zajištění

Určete, zda má existovat rozbalený obsah archivního souboru. Chcete-li rozbalit archiv, zadejte tuto vlastnost jako Present. Chcete-li odebrat rozbalený obsah archivu, zadejte tuto vlastnost jako Absent. Výchozí hodnota je Present.

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

Force

Určete, zda chcete přepsat existující obsah v cíli. Při vynucení dojde $falsek chybám prostředku, pokud je potřeba přepsat položku v cíli. Výchozí hodnota je $false.

Type: System.Boolean
Default Value: false

Ověření

Určete, zda chcete ověřit rozbalený obsah zadanou metodou kontrolního součtu. Výchozí hodnota je $false.

Pokud je $trueověření a soubor v cíli neodpovídá souboru v archivu:

Pokud je $falseověření a vynucení, Present dojde k chybám prostředku se zprávou, že soubor v cíli nejde přepsat.
Pokud je $truezajistěte a vynutit, Present prostředek soubor přepíše.
Pokud je toAbsentzajištěno, prostředek soubor neodebere.

Type: System.Boolean
Default Value: false

Sdílet prostřednictvím