DSC WindowsPackageCab-erőforrásDSC WindowsPackageCab Resource

A következőkre vonatkozik: Windows PowerShell 5,1Applies To: Windows PowerShell 5.1

A Windows PowerShell desired State Configuration (DSC) WindowsPackageCab erőforrása lehetővé teszi a Windows kabinet (. cab) csomagok telepítésére és eltávolítására szolgáló mechanizmust a célként megadott csomóponton.The WindowsPackageCab resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to install or uninstall Windows cabinet (.cab) packages on a target node.

A célként megadott csomóponton telepítve kell lennie a DISM PowerShell-modulnak.The target node must have the DISM PowerShell module installed. További információ: a DISM használata a Windows PowerShellben.For information, see Use DISM in Windows PowerShell.

Megjegyzés

A DSC-erőforrás ezen dokumentációja a PowerShell részét képező verziót fedi le.This documentation of this DSC resource covers the version that is included with PowerShell. A PSDscResources modul olyan új és frissített frissítést tartalmaz, amelyet a Microsoft hivatalosan támogat.The PSDscResources module contains new and updated that are officially supported by Microsoft. A PSDscResources modul a PowerShell-Galéria érhető el.The PSDscResources module is available from the PowerShell Gallery.

További információért és a frissített dokumentációért tekintse meg a következő témakört: readme a GitHub-tárházban.For more information and updated documentation, see the README in the GitHub repository.

SyntaxSyntax

{
    Name = [string]
    SourcePath = [string]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    Ensure = [string] { Absent | Present }
    [ PsDscRunAsCredential = [PSCredential] ]
}

TulajdonságokProperties

TulajdonságProperty LeírásDescription
NévName Megadja annak a csomagnak a nevét, amely számára biztosítani szeretné az adott állapotot.Indicates the name of the package for you want to ensure a specific state.
SourcePathSourcePath Megadja azt az elérési utat, ahol a csomag található.Indicates the path where the package resides.
LogPathLogPath Megadja a teljes elérési utat, ahol a szolgáltatónak mentenie kell egy naplófájlt a csomag telepítéséhez vagy eltávolításához.Indicates the full path where you want the provider to save a log file to install or uninstall the package.

Közös tulajdonságokCommon properties

TulajdonságProperty LeírásDescription
DependsOnDependsOn Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt.Indicates that the configuration of another resource must run before this resource is configured. Ha például az az erőforrás-konfigurációs parancsfájl blokkja, amelyet először szeretne futtatni, ResourceName, és a típusa ResourceType, a tulajdonság használatának szintaxisa a következő: 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".
BiztosításaEnsure Azt jelzi, hogy telepítve van-e a csomag.Indicates if the package is installed. Állítsa a tulajdonságot hiányzó értékre, hogy a csomag ne legyen telepítve (vagy a csomag eltávolítása, ha telepítve van).Set this property to Absent to ensure the package is not installed (or uninstall the package if it is installed). Állítsa be úgy , hogy a csomag telepítve legyen.Set it to Present to ensure the package is installed. Győződjön meg arról , hogy a WindowsPackageCab erőforrás kötelező tulajdonsága.Ensure is a required property on the WindowsPackageCab resource.
PsDscRunAsCredentialPsDscRunAsCredential Beállítja a teljes erőforrás futtatásához használt hitelesítő adatokat.Sets the credential for running the entire resource as.

PéldaExample

Az alábbi példában szereplő konfiguráció bemeneti paramétereket használ, és biztosítja, hogy a paraméterben megadott. cab fájl $Name telepítve legyen.The following example configuration takes input parameters, and ensures that the .cab file specified by the $Name parameter is installed.

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