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 via de PowerShell Gallery.

Zie de psdscResources-referentiedocumentatie voor meer informatie en bijgewerkte documentatie.

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

Eigenschappen

Eigenschap	Beschrijving
Doel	Hiermee geeft u de locatie op waar u ervoor wilt zorgen dat de archiefinhoud wordt geëxtraheerd.
Pad	Hiermee geeft u het bronpad van het archiefbestand op.
Controlesom	Definieert het type dat moet worden gebruikt om te bepalen of twee bestanden hetzelfde zijn. Als Controlesom niet is opgegeven, wordt alleen de naam van het bestand of de map gebruikt voor de vergelijking. Geldige waarden zijn: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. Als u Controlesom zonder Valideren opgeeft, mislukt de configuratie.
Referentie	De referentie van een gebruikersaccount met machtigingen voor toegang tot het opgegeven archiefpad en -doel, indien nodig.
Force	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 Force gebruikt, worden dergelijke fouten overschreven. De standaardwaarde is False.
Valideren	Hiermee wordt de eigenschap Checksum gebruikt om te bepalen of het archief overeenkomt met de handtekening. Als u Controlesom zonder Valideren opgeeft, mislukt de configuratie. Als u Valideren zonder controlesom opgeeft, wordt standaard een SHA-256-controlesom gebruikt.

Algemene eigenschappen

Eigenschap	Beschrijving
DependsOn	Geeft aan dat de configuratie van een andere resource moet worden uitgevoerd voordat deze resource wordt geconfigureerd. Als de id van het resourceconfiguratiescriptblok dat u als eerste wilt uitvoeren bijvoorbeeld ResourceName is en het type ResourceType is, is DependsOn = "[ResourceType]ResourceName"de syntaxis voor het gebruik van deze eigenschap .
Verifiëren	Bepaalt of u wilt controleren 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 Afwezig om ervoor te zorgen dat ze niet bestaan. De standaardwaarde is Aanwezig.
PsDscRunAsCredential	Hiermee stelt u de referentie voor het uitvoeren van de hele resource als in.

Notitie

De algemene eigenschap PsDscRunAsCredential 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-resources voor 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"
}