DSC-archiefresource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.x

De archiefresource in Windows PowerShell Desired State Configuration (DSC) biedt een mechanisme voor het uitpakken van archiefbestanden (.zip) op een specifiek pad.

Notitie

Deze documentatie van deze DSC-resource heeft betrekking op de versie die is opgenomen in PowerShell vóór versie 7.2. De PSDscResources-module bevat nieuwe en bijgewerkte DSC-resources die officieel worden ondersteund door Microsoft. De PSDscResources module is beschikbaar in de PowerShell Gallery.

Zie de referentiedocumentatie voor PSDscResourcesvoor meer informatie en bijgewerkte documentatie.

Syntaxis

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

Eigenschappen

Eigenschap	Beschrijving
Bestemming	Hiermee geeft u de locatie op waar u wilt controleren of de archiefinhoud wordt geëxtraheerd.
Pad	Hiermee geeft u het bronpad van het archiefbestand.
Checksum	Definieert het type dat moet worden gebruikt bij het bepalen of twee bestanden hetzelfde zijn. Als controlesom niet is opgegeven, wordt alleen de naam van het bestand of de map gebruikt voor vergelijking. Geldige waarden zijn: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. Als u controlesom opgeeft zonder valideren, mislukt de configuratie.
Geloofsbrief	De referenties van een gebruikersaccount met machtigingen voor toegang tot het opgegeven archiefpad en het opgegeven doel, indien nodig.
Kracht	Bepaalde bestandsbewerkingen (zoals het overschrijven van een bestand of het verwijderen van een map die niet leeg is) leiden tot een fout. Als u de eigenschap Forceren gebruikt, worden dergelijke fouten overschreven. De standaardwaarde is False.
Valideren	Gebruikt de eigenschap Checksum om te bepalen of het archief overeenkomt met de handtekening. Als u controlesom opgeeft zonder valideren, mislukt de configuratie. Als u valideren zonder Controlesomopgeeft, wordt standaard een SHA-256Controlesom gebruikt.

Algemene eigenschappen

Eigenschap	Beschrijving
DependsOn	Geeft aan dat de configuratie van een andere resource moet worden uitgevoerd voordat deze resource is geconfigureerd. Als de id van het scriptblok voor resourceconfiguratie dat u eerst wilt uitvoeren bijvoorbeeld ResourceName is en het type ResourceType is, is de syntaxis voor het gebruik van deze eigenschap DependsOn = "[ResourceType]ResourceName".
Verzekeren	Bepaalt of de inhoud van het archief bestaat op de Bestemming. Stel deze eigenschap in op Presenteren om ervoor te zorgen dat de inhoud bestaat. Stel deze in op Afwezige om ervoor te zorgen dat deze niet bestaan. De standaardwaarde is Presenteren.
PsDscRunAsCredential	Hiermee stelt u de referentie in voor het uitvoeren van de hele resource als.

Notitie

De PsDscRunAsCredential algemene eigenschap is toegevoegd in WMF 5.0 om het uitvoeren van een DSC-resource in de context van andere referenties toe te staan. Zie Referenties gebruiken met DSC-resourcesvoor meer informatie.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de archiefresource gebruikt om ervoor te zorgen dat de inhoud van een archiefbestand met de naam Test.zip bestaat en wordt geëxtraheerd op een bepaalde bestemming met behulp van en geautoriseerd.

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