DSC-archief resource

  • Artikel
  • 2 minuten om te lezen

Van toepassing op: Windows Power Shell 4,0, Windows Power shell 5. x

De archief resource in Windows Power shell desired state Configuration (DSC) biedt een mechanisme voor het uitpakken van archief bestanden (. zip) op een specifiek pad.

Notitie

Deze documentatie van deze DSC-resource bevat informatie over de versie die is opgenomen in PowerShell. De PSDscResources-module bevat nieuwe en bijgewerkte modules die officieel worden ondersteund door Microsoft. De PSDscResources-module is beschikbaar via de PowerShell Gallery.

Zie voor meer informatie en bijgewerkte documentatie het LEESMIJ in de GitHub opslagplaats.

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 de archief inhoud moet worden uitgepakt.
Pad Hiermee geeft u het bronpad van het archief bestand.
Controlesom Hiermee wordt bepaald welk type moet worden gebruikt om te bepalen of twee bestanden hetzelfde zijn. Als er geen controlesom 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 validatie opgeeft, mislukt de configuratie.
Referentie De referentie van een gebruikers account met machtigingen voor toegang tot het opgegeven pad en de bestemming van het archief, indien nodig.
Force Bepaalde bestands bewerkingen (zoals het overschrijven van een bestand of het verwijderen van een map die niet leeg is), resulteren in een fout. Met behulp van de eigenschap Force worden dergelijke fouten genegeerd. De standaard waarde is False .
Valideren Maakt gebruik van de eigenschap checksum om te bepalen of het archief overeenkomt met de hand tekening. Als u controlesom zonder validatie opgeeft, mislukt de configuratie. Als u Validate zonder controlesom opgeeft, wordt standaard een SHA-256- controlesom gebruikt.

Algemene eigenschappen

Eigenschap Beschrijving
DependsOn Geeft aan dat de configuratie van een andere bron moet worden uitgevoerd voordat deze resource wordt geconfigureerd. De syntaxis voor het gebruik van deze eigenschap is bijvoorbeeld als de ID van het resource-script blok dat u als eerste wilt uitvoeren, de naam ResourceName is en het type van de bron resource is DependsOn = "[ResourceType]ResourceName" .
Zo Hiermee wordt bepaald of wordt gecontroleerd of de inhoud van het archief bestaat op de bestemming . Stel deze eigenschap in op aanwezig om te controleren of de inhoud bestaat. Stel deze in op afwezig om ervoor te zorgen dat ze niet bestaan. De standaard waarde is aanwezig .
PsDscRunAsCredential Hiermee stelt u de referentie in voor het uitvoeren van de gehele resource als.

Notitie

De algemene eigenschap PsDscRunAsCredential is toegevoegd aan 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 voor beeld ziet u hoe u de archief resource gebruikt om ervoor te zorgen dat de inhoud van een archief bestand Test.zip bestaat en dat wordt geëxtraheerd op een bepaald doel met en gemachtigd.

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