Archivní prostředek DSC

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