Zasób DSC WindowsPackageCab

Dotyczy: Windows PowerShell 5.1

Zasób WindowsPackageCab w Windows PowerShell Desired State Configuration (DSC) udostępnia mechanizm instalowania lub odinstalowywania pakietów szafki systemu Windows (.cab) w węźle docelowym.

Węzeł docelowy musi mieć zainstalowany moduł DISM programu PowerShell. Aby uzyskać informacje, zobacz Use DISM in Windows PowerShell (Używanie narzędzia DISM w Windows PowerShell).

Uwaga

Ta dokumentacja tego zasobu DSC obejmuje wersję dołączoną do programu PowerShell w wersji 7.2. Moduł PSDscResources zawiera nowe i zaktualizowane zasoby DSC, które są oficjalnie obsługiwane przez firmę Microsoft. Moduł PSDscResources jest dostępny w Galeria programu PowerShell.

Aby uzyskać więcej informacji i zaktualizować dokumentację, zobacz dokumentację referencyjną usługi PSDscResources.

Składnia

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

Właściwości

Właściwość	Opis
Nazwa	Wskazuje nazwę pakietu, który chcesz zapewnić określony stan.
SourcePath	Wskazuje ścieżkę, w której znajduje się pakiet.
Ścieżka dziennika	Wskazuje pełną ścieżkę, w której dostawca ma zapisać plik dziennika w celu zainstalowania lub odinstalowania pakietu.

Wspólne właściwości

Właściwość	Opis
Dependson	Wskazuje, że konfiguracja innego zasobu musi zostać uruchomiona przed skonfigurowaniem tego zasobu. Jeśli na przykład identyfikator bloku skryptu konfiguracji zasobu, który chcesz uruchomić jako pierwszy, to ResourceName, a jego typ to ResourceType, składnia użycia tej właściwości to DependsOn = "[ResourceType]ResourceName".
Zapewnić	Wskazuje, czy pakiet jest zainstalowany. Ustaw tę właściwość na Brak , aby upewnić się, że pakiet nie jest zainstalowany (lub odinstaluj pakiet, jeśli jest zainstalowany). Ustaw ją na Wartość Prezent , aby upewnić się, że pakiet jest zainstalowany. Upewnij się, że właściwość jest wymagana w zasobie WindowsPackageCab .
PsDscRunAsCredential	Ustawia poświadczenie na potrzeby uruchamiania całego zasobu jako.

Przykład

Poniższa przykładowa konfiguracja pobiera parametry wejściowe i zapewnia zainstalowanie pliku .cab określonego $Name przez parametr .

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