Risorsa WindowsPackageCab DSCDSC WindowsPackageCab Resource

Si applica a: Windows PowerShell 5.1Applies To: Windows PowerShell 5.1

La risorsa WindowsPackageCab in Windows PowerShell DSC (Desired State Configuration) offre un meccanismo per installare o disinstallare pacchetti CAB in un nodo di destinazione.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.

È necessario che nel nodo di destinazione sia installato il modulo PowerShell Gestione e manutenzione immagini distribuzione.The target node must have the DISM PowerShell module installed. Per informazioni, vedere Usare Gestione e manutenzione immagini distribuzione in Windows PowerShell.For information, see Use DISM in Windows PowerShell.

Nota

La documentazione di questa risorsa DSC riguarda la versione inclusa in PowerShell.This documentation of this DSC resource covers the version that is included with PowerShell. Il modulo PSDscResources contiene elementi nuovi e aggiornati ufficialmente supportati da Microsoft.The PSDscResources module contains new and updated that are officially supported by Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.The PSDscResources module is available from the PowerShell Gallery.

Per altre informazioni e per la documentazione aggiornata, vedere il file LEGGIMI nel repository GitHub.For more information and updated documentation, see the README in the GitHub repository.

SintassiSyntax

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

ProprietàProperties

ProprietàProperty DescrizioneDescription
NomeName Indica il nome del pacchetto per cui si vuole specificare un determinato stato.Indicates the name of the package for you want to ensure a specific state.
SourcePathSourcePath Percorso in cui si trova il pacchetto.Indicates the path where the package resides.
LogPathLogPath Indica il percorso completo in cui il provider deve salvare un file di log per installare o disinstallare il pacchetto.Indicates the full path where you want the provider to save a log file to install or uninstall the package.

Proprietà comuniCommon properties

ProprietàProperty DescrizioneDescription
DependsOnDependsOn Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa.Indicates that the configuration of another resource must run before this resource is configured. Ad esempio, se il valore di ID del blocco script di configurazione della risorsa che si vuole eseguire per primo è ResourceName e il tipo è ResourceType, la sintassi per usare questa proprietà è 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".
EnsureEnsure Indica se il pacchetto è installato.Indicates if the package is installed. Impostare questa proprietà su Absent per assicurarsi che il pacchetto non sia installato (o disinstallare il pacchetto se è installato).Set this property to Absent to ensure the package is not installed (or uninstall the package if it is installed). Impostarla su Present per assicurarsi che il pacchetto sia installato.Set it to Present to ensure the package is installed. Ensure è una proprietà obbligatoria per la risorsa WindowsPackageCab .Ensure is a required property on the WindowsPackageCab resource.
PsDscRunAsCredentialPsDscRunAsCredential Imposta le credenziali per l'esecuzione dell'intera risorsa.Sets the credential for running the entire resource as.

EsempioExample

La configurazione di esempio seguente accetta parametri di input e assicura che venga installato il file con estensione cab specificato dal parametro $Name.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
    }
}