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
}
}
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla