Sumber Daya Paket DSC

Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x

Sumber daya Paket di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk menginstal atau menghapus paket, seperti Pemasang Windows dan paket setup.exe, pada simpul target.

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

Package [string] #ResourceName
{
    Name = [string]
    Path = [string]
    ProductId = [string]
    [ Arguments = [string] ]
    [ Credential = [PSCredential] ]
    [ LogPath = [string] ]
    [ ReturnCode = [UInt32[]] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Properti

Properti	Deskripsi
Nama	Menunjukkan nama paket yang ingin Anda pastikan statusnya.
Jalur	Menunjukkan jalur tempat paket berada.
ProductId	Menunjukkan ID produk yang secara unik mengidentifikasi paket.
Argumen	Mencantumkan string argumen yang akan diteruskan ke paket persis seperti yang disediakan.
Kredensial	Menyediakan akses ke paket pada sumber jarak jauh. Properti ini tidak digunakan untuk menginstal paket. Paket selalu diinstal pada sistem lokal.
LogPath	Menunjukkan jalur lengkap tempat Anda ingin penyedia menyimpan file log untuk menginstal atau menghapus instalasi paket.
ReturnCode	Menunjukkan kode pengembalian yang diharapkan. Jika kode pengembalian aktual tidak cocok dengan nilai yang diharapkan yang disediakan di sini, konfigurasi akan mengembalikan kesalahan.

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. Nilai defaultnya adalah Ada.
PsDscRunAsCredential	Mengatur kredensial untuk menjalankan seluruh sumber daya sebagai.

Catatan

Properti umum PsDscRunAsCredential ditambahkan dalam WMF 5.0 untuk memungkinkan menjalankan sumber daya DSC apa pun dalam konteks info masuk lainnya. Untuk informasi selengkapnya, lihat Menggunakan Kredensial dengan Sumber Daya DSC.

Contoh

Contoh ini menjalankan alat penginstal .msi yang terletak di jalur yang ditentukan dan memiliki ID produk yang ditentukan.

Configuration PackageTest
{
    Import-DscResource -ModuleName 'PSDesiredStateConfiguration'

    Package PackageExample
    {
        Ensure      = "Present"  # You can also set Ensure to "Absent"
        Path        = "$Env:SystemDrive\TestFolder\TestProject.msi"
        Name        = "TestPackage"
        ProductId   = "ACDDCDAF-80C6-41E6-A1B9-8ABD8A05027E"
    }
}