Sumber Daya DSC WindowsPackageCab

Berlaku Untuk: Windows PowerShell 5.1

Sumber daya WindowsPackageCab di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk menginstal atau menghapus paket kabinet Windows (.cab) pada simpul target.

Simpul target harus menginstal modul DISM PowerShell. Untuk informasi, lihat Menggunakan DISM di Windows PowerShell.

Catatan

Dokumentasi sumber daya DSC ini mencakup versi yang disertakan dengan PowerShell sebelum versi 7.2. Modul PSDscResources berisi Sumber Daya DSC baru dan yang diperbarui yang secara resmi didukung oleh Microsoft. Modul PSDscResources tersedia dari Galeri PowerShell.

Untuk informasi selengkapnya dan dokumentasi yang diperbarui, lihat dokumentasi referensi PSDscResources.

Sintaks

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

Properti

Properti	Deskripsi
Nama	Menunjukkan nama paket untuk Anda ingin memastikan status tertentu.
SourcePath	Menunjukkan jalur tempat paket berada.
LogPath	Menunjukkan jalur lengkap tempat Anda ingin penyedia menyimpan file log untuk menginstal atau menghapus instalasi paket.

Properti umum

Properti	Deskripsi
DependsOn	Menunjukkan bahwa konfigurasi sumber daya lain harus berjalan sebelum sumber daya ini dikonfigurasi. Misalnya, jika ID blok skrip konfigurasi sumber daya yang ingin Anda jalankan terlebih dahulu adalah ResourceName dan jenisnya adalah ResourceType, sintaks untuk menggunakan properti ini adalah DependsOn = "[ResourceType]ResourceName".
Pastikan	Menunjukkan apakah paket diinstal. Atur properti ini ke Absent untuk memastikan paket tidak diinstal (atau hapus instalan paket jika diinstal). Atur ke Sajikan untuk memastikan paket diinstal. Pastikan adalah properti yang diperlukan pada sumber daya WindowsPackageCab .
PsDscRunAsCredential	Mengatur kredensial untuk menjalankan seluruh sumber daya sebagai.

Contoh

Contoh konfigurasi berikut mengambil parameter input, dan memastikan bahwa file .cab yang ditentukan oleh $Name parameter diinstal.

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