DSC-WindowsPackageCab ResourceDSC WindowsPackageCab Resource

Van toepassing op: Windows PowerShell 5.1 en hogerApplies To: Windows PowerShell 5.1 and later

De WindowsPackageCab in Windows PowerShell Desired State Configuration (DSC)-bron biedt een mechanisme om te installeren of verwijderen van Windows-CAB-pakketten in een doelknooppunt.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.

Het doelknooppunt moet de DISM-PowerShell-module geïnstalleerd hebben.The target node must have the DISM PowerShell module installed. Zie voor informatie Gebruik DISM in Windows PowerShell.For information, see Use DISM in Windows PowerShell.

SyntaxisSyntax

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

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
NaamName Geeft de naam van het pakket voor u wilt een specifieke status zorgen.Indicates the name of the package for you want to ensure a specific state.
Zorg ervoor datEnsure Hiermee wordt aangegeven of het pakket is geïnstalleerd.Indicates if the package is installed. Deze eigenschap instellen op 'Afwezig' controleert u dat het pakket niet is geïnstalleerd (of het pakket verwijderen als deze is geïnstalleerd).Set this property to "Absent" to ensure the package is not installed (or uninstall the package if it is installed). Instellen om "" (de standaardwaarde) om te controleren of dat het pakket is geïnstalleerd.Set it to "Present" (the default value) to ensure the package is installed.
PadPath Geeft het pad waar het pakket zich bevindt.Indicates the path where the package resides.
LogboekpadLogPath Hiermee geeft u het volledige pad waar u de provider een logboekbestand om te installeren of verwijderen van het pakket opslaan.Indicates the full path where you want the provider to save a log file to install or uninstall the package.
dependsOnDependsOn Hiermee wordt aangegeven dat de configuratie van een andere resource uitvoeren moet voordat deze bron is geconfigureerd.Indicates that the configuration of another resource must run before this resource is configured. Bijvoorbeeld, als de ID van de resourceconfiguratie scriptblok die u wilt uitvoeren eerst is ResourceName en het type ResourceType, de syntaxis voor het gebruik van deze eigenschap is ' 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"``.

VoorbeeldExample

De volgende voorbeeldconfiguratie parameters nodig heeft, en zorgt ervoor dat het CAB-bestand opgegeven door de $Name parameter is geïnstalleerd.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
    }
}