DSC voor Linux nxArchive ResourceDSC for Linux nxArchive Resource

De nxArchive in PowerShell Desired State Configuration (DSC)-bron biedt een mechanisme voor het uitpakken van bestanden te archiveren (tar, .zip) op een specifiek pad op een Linux-knooppunt.The nxArchive resource in PowerShell Desired State Configuration (DSC) provides a mechanism to unpack archive (.tar, .zip) files at a specific path on a Linux node.

SyntaxisSyntax

nxArchive <string> #ResourceName
{
    SourcePath = <string>
    DestinationPath = <string>
    [ Checksum = <string> { ctime | mtime | md5 }  ]
    [ Force = <bool> ]
    [ DependsOn = <string[]> ]
    [ Ensure = <string> { Absent | Present }  ]
}

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
SourcePathSourcePath Hiermee geeft u het bronpad van het bestand.Specifies the source path of the archive file. Dit moet een tar .zip, of..GZ-bestand.This should be a .tar, .zip, or .tar.gz file.
DestinationPathDestinationPath 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.
ControlesomChecksum Definieert het type moet worden gebruikt bij het bepalen of de bron-archief is bijgewerkt.Defines the type to use when determining whether the source archive has been updated. Waarden zijn: 'ctime', 'mtime' of 'md5'.Values are: "ctime", "mtime", or "md5". De standaardwaarde is 'md5'.The default value is "md5".
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 behulp van de Force eigenschap heeft een dergelijke fouten.Using the Force property overrides such errors. De standaardwaarde is $false.The default value is $false.
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 de resource is scriptblok configuratie die u wilt uitvoeren eerst ResourceName en het type ResourceType, de syntaxis voor het gebruik van deze de 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".
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 dat de inhoud bestaat.Set this property to "Present" to ensure the contents exist. Stel deze in op 'Ontbreekt' om te controleren of dat ze bestaan niet.Set it to "Absent" to ensure they do not exist. De standaardwaarde is 'Aanwezig'.The default value is "Present".

VoorbeeldExample

Het volgende voorbeeld ziet u hoe u de nxArchive resource om ervoor te zorgen dat de inhoud van een archiefbestand aangeroepen website.tar bestaan en op een bepaalde bestemming worden opgehaald.The following example shows how to use the nxArchive resource to ensure that the contents of an archive file called website.tar exist and are extracted at a given destination.

Import-DSCResource -Module nx 

nxFile SyncArchiveFromWeb
{
   Ensure = "Present"
   SourcePath = “http://release.contoso.com/releases/website.tar”
   DestinationPath = "/usr/release/staging/website.tar"
   Type = "File"
   Checksum = “mtime”
}

nxArchive SyncWebDir
{
   SourcePath = “/usr/release/staging/website.tar”
   DestinationPath = “/usr/local/apache2/htdocs/”
   Force = $false
   DependsOn = "[nxFile]SyncArchiveFromWeb"
}