DSC archív erőforrás

Érintett kiadások: Windows PowerShell 4.0, Windows PowerShell 5.x

A Windows PowerShell Desired State Configuration (DSC) archív erőforrása lehetővé teszi az archív (.zip) fájlok kicsomagolását egy adott elérési úton.

Megjegyzés

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját ismerteti. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul a PowerShell-galéria érhető el.

További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.

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

Tulajdonságok

Tulajdonság	Leírás
Cél	Megadja azt a helyet, ahová az archívum tartalmát ki szeretné nyerni.
Elérési út	Megadja az archív fájl forrásútvonalát.
Ellenőrzőösszeg	Meghatározza a két fájl azonosságának megállapításához használandó típust. Ha az Ellenőrzőösszeg nincs megadva, csak a fájl vagy a könyvtár nevét használja az összehasonlításhoz. Az érvényes értékek a következők: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. Ha ellenőrzés nélkül adja meg az Ellenőrzőösszeget, a konfiguráció sikertelen lesz.
Hitelesítő adat	A megadott archív elérési út és cél eléréséhez szükséges engedélyekkel rendelkező felhasználói fiók hitelesítő adatai.
Force	Bizonyos fájlműveletek (például egy fájl felülírása vagy egy nem üres könyvtár törlése) hibát eredményeznek. A Force tulajdonság használata felülírja az ilyen hibákat. Az alapértelmezett érték a Hamis.
Érvényesítés	Az Ellenőrzőösszeg tulajdonság használatával állapítja meg, hogy az archívum megfelel-e az aláírásnak. Ha ellenőrzés nélkül adja meg az Ellenőrzőösszeget, a konfiguráció sikertelen lesz. Ha az Ellenőrzésellenőrzőösszeg nélkül beállítást adja meg, a rendszer alapértelmezés szerint egy SHA-256ellenőrzőösszeget használ.

Közös tulajdonságok

Tulajdonság	Leírás
DependsOn	Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt. Ha például az először futtatni kívánt erőforrás-konfigurációs szkriptblokk azonosítója ResourceName, és a típusa ResourceType, akkor a tulajdonság használatának szintaxisa a következő DependsOn = "[ResourceType]ResourceName": .
Biztosítja	Meghatározza, hogy az archívum tartalma megtalálható-e a célhelyen. A tartalom meglétének ellenőrzéséhez állítsa ezt a tulajdonságot Present (Jelen ) értékre. A Hiányzó értékre állítva győződjön meg arról, hogy nem léteznek. Az alapértelmezett érték a Jelenik.
PsDscRunAsCredential	Beállítja a teljes erőforrás futtatásához szükséges hitelesítő adatokat.

Megjegyzés

A PsDscRunAsCredential közös tulajdonság hozzáadva a WMF 5.0-hoz, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

Az alábbi példa bemutatja, hogyan használhatja az Archív erőforrást annak biztosítására, hogy a nevű Test.zip archív fájl tartalma létezik, és egy adott célhelyen legyen kinyerve a használatával és engedélyével.

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