Sdílet prostřednictvím

Archivní prostředek DSC

  • Článek

Platí pro: Windows PowerShell 4.0, Windows PowerShell 5.x

Prostředek archivu ve službě Windows PowerShell Desired State Configuration (DSC) poskytuje mechanismus pro rozbalení souborů archivu (.zip) v konkrétní cestě.

Poznámka

Tato dokumentace tohoto prostředku DSC se zabývá verzí, která je součástí PowerShellu před verzí 7.2. Modul PSDscResources obsahuje nové a aktualizované prostředky DSC, které oficiálně podporuje Microsoft. Modul PSDscResources je k dispozici v galerii Prostředí PowerShell.

Další informace a aktualizovaná dokumentace naleznete v referenční dokumentaci PSDscResources.

Syntax

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

Vlastnosti

Vlastnost Popis
Cíl Určuje umístění, kam chcete zajistit extrahování obsahu archivu.
Cesta Určuje zdrojová cesta archivního souboru.
Kontrolní součet Definuje typ, který se má použít při určování, zda jsou dva soubory stejné. Pokud není zadán Kontrolní součet, použije se k porovnání pouze název souboru nebo adresáře. Mezi platné hodnoty patří: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. Pokud zadáte kontrolní součet bez Ověřit, konfigurace selže.
Pověření Přihlašovací údaje uživatelského účtu s oprávněními pro přístup k zadané cestě archivu a cíli v případě potřeby.
Síla Některé operace se soubory (například přepsání souboru nebo odstranění adresáře, který není prázdný), způsobí chybu. Použití vlastnosti Force tyto chyby přepíše. Výchozí hodnota je false.
Ověřit Používá Checksum vlastnost k určení, zda archiv odpovídá podpisu. Pokud zadáte kontrolní součet bez Ověřit, konfigurace selže. Pokud zadáte Ověřit bezkontrolního součtu SHA-256Kontrolní s oučet, použije se ve výchozím nastavení.

Společné vlastnosti

Vlastnost Popis
DependsOn Označuje, že konfigurace jiného prostředku musí běžet před nakonfigurování tohoto prostředku. Pokud například ID bloku skriptu konfigurace prostředku, který chcete spustit jako první, je ResourceName a jeho typ je ResourceType, syntaxe pro použití této vlastnosti je DependsOn = "[ResourceType]ResourceName".
Zajišťovat Určuje, zda chcete zkontrolovat, zda obsah archivu existuje v cílovém . Nastavte tuto vlastnost na Prezentovat, aby se zajistilo, že obsah existuje. Nastavte ho na Chybějící, abyste zajistili, že neexistují. Výchozí hodnota je present.
PsDscRunAsCredential Nastaví přihlašovací údaje pro spuštění celého prostředku jako.

Poznámka

Do WMF 5.0 byla přidána PsDscRunAsCredential společná vlastnost, která umožňuje spuštění jakéhokoli prostředku DSC v kontextu jiných přihlašovacích údajů. Další informace najdete v tématu Použití přihlašovacích údajů s prostředky DSC.

Příklad

Následující příklad ukazuje, jak pomocí prostředku Archiv zajistit, aby obsah archivního souboru s názvem Test.zip existovat a byly extrahovány v daném cíli pomocí a autorizované.

Archive ArchiveExample {
    Ensure = "Present"
    Path = "C:\Users\Public\Documents\Test.zip"
    Destination = "C:\Users\Public\Documents\ExtractionPath"
}