DSC WindowsPackageCab erőforrás

Érintett kiadások: Windows PowerShell 5.1

A Windows PowerShell Desired State Configuration (DSC) WindowsPackageCab erőforrása lehetővé teszi a Windows-kabinetcsomagok (.cab) telepítését vagy eltávolítását a célcsomóponton.

A célcsomóponton telepítve kell lennie a DISM PowerShell-modulnak. További információ: A DISM használata Windows PowerShell.

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

{
    Name = [string]
    SourcePath = [string]
    [ LogPath = [string] ]
    [ 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, amelyről gondoskodni szeretne egy adott állapotról.
SourcePath	A csomag elérési útját jelzi.
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.

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	Azt jelzi, hogy a csomag telepítve van-e. Állítsa ezt a tulajdonságot Hiányzó értékre, hogy a csomag ne legyen telepítve (vagy távolítsa el a csomagot, ha telepítve van). Állítsa a Bemutató értékre a csomag telepítésének ellenőrzéséhez. Győződjön meg arról , hogy a WindowsPackageCab erőforrás kötelező tulajdonsága.
PsDscRunAsCredential	Beállítja a teljes erőforrás futtatásához szükséges hitelesítő adatokat.

Példa

Az alábbi példakonfiguráció bemeneti paramétereket alkalmaz, és biztosítja, hogy a paraméter által $Name megadott .cab fájl telepítve legyen.

Configuration Sample_WindowsPackageCab
{
    param
    (
        [Parameter (Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $Name,

        [Parameter (Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $SourcePath,

        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $LogPath
    )

    Import-DscResource -ModuleName 'PSDscResources'

    WindowsPackageCab WindowsPackageCab1
    {
        Name = $Name
        Ensure = 'Present'
        SourcePath = $SourcePath
        LogPath = $LogPath
    }
}