DSC archív erőforrás

A következőkre vonatkozik: Windows PowerShell 4.0, Windows PowerShell 5.x

A Windows PowerShell Desired State Configuration (DSC) archívumerőforrása egy mechanizmust biztosít az archív (.zip) fájlok egy adott útvonalon való kicsomagolására.

Jegyzet

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját tartalmazza. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmazza. A PSDscResources modul a PowerShell-gyűjteményből érhető el.

További információ és frissített dokumentáció: PSDscResources referenciadokumentáció.

Szintaxis

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

Kellékek

Ingatlan	Leírás
Célállomás	Megadja azt a helyet, ahol biztosítani szeretné, hogy az archívum tartalma ki legyen nyerve.
Ösvény	Az archív fájl forrásútvonalát adja meg.
Ellenőrzőösszeg	Meghatározza a két fájl azonosságának meghatározásához használandó típust. Ha Ellenőrzőösszeg nincs megadva, a rendszer csak a fájl- vagy könyvtárnevet 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őösszegEllenőrzésenélkül adja meg, a konfiguráció sikertelen lesz.
Megbízólevél	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.
Erő	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 Hamis.
Érvényesít	A Checksum tulajdonság használatával állapítja meg, hogy az archívum megfelel-e az aláírásnak. Ha EllenőrzőösszegEllenőrzésenélkül adja meg, a konfiguráció sikertelen lesz. Ha Ellenőrzőösszegnélkül Érvényesíti a, alapértelmezés szerint egy SHA-256Ellenőrzőösszeg használ.

Gyakori tulajdonságok

Ingatlan	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 elsőként futtatni kívánt erőforráskonfigurációs szkriptblokk azonosítója ResourceName, és típusa ResourceType, akkor a tulajdonság használatának szintaxisa DependsOn = "[ResourceType]ResourceName".
Biztosít	Meghatározza, hogy az archívum tartalma megtalálható-e a Cél. Állítsa be ezt a tulajdonságot úgy, hogy Jelen a tartalom meglétének biztosításához. Állítsa be a hiányzó , hogy ne legyenek léteznek. Az alapértelmezett érték Jelen.
PsDscRunAsCredential	Beállítja a hitelesítő adatokat a teljes erőforrás futtatásához.

Jegyzet

A PsDscRunAsCredential common tulajdonság hozzáadva lett a WMF 5.0-s verziójához, hogy bármilyen DSC-erőforrást futtathasson más hitelesítő adatokkal összefüggésben. 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 Test.zip nevű archív fájl tartalma létezik, és azokat egy adott célhelyen nyeri ki és használja és engedélyezi.

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