Archiveren van de DSC-ResourceDSC Archive Resource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

De archief-resource in Windows PowerShell Desired State Configuration (DSC) biedt een mechanisme uit te pakken archiefbestanden (.zip) op een specifiek pad.The Archive resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to unpack archive (.zip) files at a specific path.

SyntaxisSyntax

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

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
BestemmingDestination Hiermee geeft u de locatie waar u Zorg ervoor dat de inhoud van het archief worden opgehaald.Specifies the location where you want to ensure the archive contents are extracted.
PadPath Hiermee geeft u het bronpad van het bestand.Specifies the source path of the archive file.
ControlesomChecksum Definieert het type moet worden gebruikt bij het bepalen of twee bestanden hetzelfde zijn.Defines the type to use when determining whether two files are the same. Als controlesom niet is opgegeven, alleen de naam van bestand of map wordt gebruikt voor vergelijking.If Checksum is not specified, only the file or directory name is used for comparison. Geldige waarden zijn: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate none (standaardwaarde).Valid values include: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate, none (default). Als u opgeeft controlesom zonder valideren, mislukt de configuratie.If you specify Checksum without Validate, the configuration will fail.
Zorg ervoor datEnsure Hiermee bepaalt u of Controleer of de inhoud van het archief bestaat op de bestemming.Determines whether to check if the content of the archive exists at the Destination. Deze eigenschap instellen op aanwezig om te controleren of de inhoud bestaat.Set this property to Present to ensure the contents exist. Stel deze in op afwezig om te controleren of ze bestaan niet.Set it to Absent to ensure they do not exist. De standaardwaarde is aanwezig.The default value is Present.
dependsOnDependsOn Hiermee wordt aangegeven dat de configuratie van een andere resource uitvoeren moet voordat deze bron is geconfigureerd.Indicates that the configuration of another resource must run before this resource is configured. Bijvoorbeeld, als de ID van het scriptblok voor resource configuratie die u wilt uitvoeren eerst ResourceName en het type is ResourceType, de syntaxis voor het gebruik van deze eigenschap is DependsOn = "[ResourceType]ResourceName".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
validerenValidate De eigenschap controlesom gebruikt om te bepalen of het archief dat overeenkomt met de handtekening.Uses the Checksum property to determine if the archive matches the signature. Als u controlesom zonder valideren opgeeft, mislukt de configuratie.If you specify Checksum without Validate, the configuration will fail. Als u valideren zonder controlesom opgeeft, wordt standaard een controlesom SHA-256 gebruikt.If you specify Validate without Checksum, a SHA-256 checksum is used by default.
ForceForce Bepaalde bestandsbewerkingen (zoals een bestand te overschrijven of verwijderen van een map die is niet leeg) leidt tot een fout opgetreden.Certain file operations (such as overwriting a file or deleting a directory that is not empty) will result in an error. Met de eigenschap Force, overschrijft dergelijke fouten.Using the Force property overrides such errors. De standaardwaarde is ONWAAR.The default value is False.

VoorbeeldExample

Het volgende voorbeeld laat zien hoe de archief-bron gebruiken om ervoor te zorgen dat de inhoud van een archiefbestand aangeroepen Test.zip bestaan en op een bepaalde bestemming worden opgehaald.The following example shows how to use the Archive resource to ensure that the contents of an archive file called Test.zip exist and are extracted at a given destination.

Archive ArchiveExample {
    Ensure = "Present"  # You can also set Ensure to "Absent"
    Path = "C:\Users\Public\Documents\Test.zip"
    Destination = "C:\Users\Public\Documents\ExtractionPath"
}