DSC-csomag erőforrása

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

A Windows PowerShell Desired State Configuration csomagerőforrása (DSC) egy olyan mechanizmust biztosít, amely lehetővé teszi a csomagok, például a Windows Installer és a setup.exe csomagok telepítését vagy eltávolítását egy célcsomóponton.

Megjegyzés

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 tartalmaz. A PSDscResources modul elérhető a PowerShell-galéria.

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

Syntax

Package [string] #ResourceName
{
    Name = [string]
    Path = [string]
    ProductId = [string]
    [ Arguments = [string] ]
    [ Credential = [PSCredential] ]
    [ LogPath = [string] ]
    [ ReturnCode = [UInt32[]] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Tulajdonságok

Tulajdonság	Leírás
Name (Név)	Annak a csomagnak a nevét jelzi, amelyhez egy adott állapotot szeretne biztosítani.
Elérési út	A csomag elérési útját jelzi.
ProductId	Azt a termékazonosítót jelöli, amely egyedileg azonosítja a csomagot.
Argumentumok	Az argumentumok sztringje, amelyet a rendszer pontosan a megadott módon ad át a csomagnak.
Hitelesítő adat	Hozzáférést biztosít a csomaghoz egy távoli forráson. Ez a tulajdonság nem használható a csomag telepítéséhez. A csomag mindig telepítve van a helyi rendszeren.
LogPath	Azt a teljes elérési utat jelzi, ahová a szolgáltató menteni szeretné a naplófájlt a csomag telepítéséhez vagy eltávolításához.
ReturnCode	A várt visszatérési kódot jelzi. Ha a tényleges visszatérési kód nem egyezik meg az itt megadott várt értékkel, a konfiguráció hibát ad vissza.

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 típusa ResourceType, akkor a tulajdonság használatának szintaxisa a DependsOn = "[ResourceType]ResourceName"következő: .
Biztosítja	Azt jelzi, hogy a csomag telepítve van-e. Állítsa ezt a tulajdonságot a Hiányzó értékre, és győződjön meg arról, hogy a csomag nincs telepítve (vagy ha telepítve van, távolítsa el a csomagot). Állítsa a Present értékre a csomag telepítésének ellenőrzéséhez. Az alapértelmezett érték a Jelen.
PsDscRunAsCredential	Beállítja a hitelesítő adatokat a teljes erőforrás futtatásához.

Megjegyzés

A PsDscRunAsCredential common tulajdonság hozzá lett adva a WMF 5.0-s verziójához, hogy bármely DSC-erőforrást más hitelesítő adatokkal összefüggésben futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

Ez a példa a megadott útvonalon található .msi telepítőt futtatja, és a megadott termékazonosítóval rendelkezik.

Configuration PackageTest
{
    Import-DscResource -ModuleName 'PSDesiredStateConfiguration'

    Package PackageExample
    {
        Ensure      = "Present"  # You can also set Ensure to "Absent"
        Path        = "$Env:SystemDrive\TestFolder\TestProject.msi"
        Name        = "TestPackage"
        ProductId   = "ACDDCDAF-80C6-41E6-A1B9-8ABD8A05027E"
    }
}