Sumber Daya Pengelolaan Paket DSC

Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.0, Windows PowerShell 5.1

Sumber daya PackageManagement di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk menginstal atau menghapus paket Manajemen Paket pada simpul target. Sumber daya ini memerlukan modul PackageManagement , tersedia dari https://PowerShellGallery.com.

Penting

Modul PackageManagement harus setidaknya versi 1.1.7.0 agar informasi properti berikut benar.

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

PackageManagement [string] #ResourceName
{
    Name = [string]
    [ AdditionalParameters = [HashTable] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string]{ Absent | Present } ]
    [ MaximumVersion = [string] ]
    [ MinimumVersion = [string] ]
    [ ProviderName = [string] ]
    [ PsDscRunAsCredential = [PSCredential] ]
    [ RequiredVersion = [string] ]
    [ Source = [string] ]
    [ SourceCredential = [PSCredential] ]
}

Properti

Properti	Deskripsi
Nama	Menentukan nama Paket yang akan diinstal atau dihapus instalasinya.
AdditionalParameters	Hashtable khusus penyedia parameter yang akan diteruskan ke Get-Package -AdditionalArguments. Misalnya, untuk penyedia NuGet, Anda dapat meneruskan parameter tambahan seperti Tujuan.
MaximumVersion	Menentukan versi maksimum paket yang diizinkan yang ingin Anda temukan. Jika Anda tidak menambahkan parameter ini, sumber daya akan menemukan versi paket tertinggi yang tersedia.
MinimumVersion	Menentukan versi minimum paket yang diizinkan yang ingin Anda temukan. Jika Anda tidak menambahkan parameter ini, sumber daya menemukan versi tertinggi yang tersedia dari paket yang juga memenuhi versi maksimum yang ditentukan yang ditentukan oleh parameter MaximumVersion .
ProviderName	Menentukan nama penyedia paket untuk mencakup pencarian paket Anda. Anda bisa mendapatkan nama penyedia paket dengan menjalankan Get-PackageProvider cmdlet .
RequiredVersion	Menentukan versi paket yang tepat yang ingin Anda instal. Jika Anda tidak menentukan parameter ini, sumber daya DSC ini menginstal versi terbaru yang tersedia dari paket yang juga memenuhi versi maksimum yang ditentukan oleh parameter MaximumVersion .
Sumber	Menentukan nama sumber paket tempat paket dapat ditemukan. Ini bisa berupa URI atau sumber yang terdaftar di Register-PackageSource atau sumber daya DSC PackageManagementSource.
SourceCredential	Menentukan akun pengguna yang memiliki hak untuk menginstal paket untuk penyedia atau sumber paket tertentu.

Parameter Tambahan

Tabel berikut ini mencantumkan opsi untuk properti AdditionalParameters.

Parameter	Deskripsi
Tujuan	Digunakan oleh penyedia seperti Penyedia Nuget bawaan. Menentukan lokasi file tempat Anda ingin menginstal paket.
InstallationPolicy	Digunakan oleh penyedia seperti Penyedia Nuget bawaan. Menentukan apakah Anda mempercayai sumber paket. Salah satu: Tidak Tepercaya atau Tepercaya.

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	Menentukan apakah paket akan diinstal atau dihapus instalasinya. 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 menginstal paket JQuery NuGet dan modul GistProvider PowerShell menggunakan sumber daya PackageManagement DSC. Contoh ini pertama-tama memastikan sumber paket yang diperlukan tersedia kemudian menentukan status paket JQuery dan GistProvider yang diharapkan (NuGet dan PowerShell, masing-masing).

Configuration PackageTest
{
    Import-DscResource -ModuleName 'PackageManagement'

    PackageManagementSource SourceRepository
    {
        Ensure      = "Present"
        Name        = "MyNuget"
        ProviderName= "Nuget"
        SourceLocation   = "http://nuget.org/api/v2/"
        InstallationPolicy ="Trusted"
    }

    PackageManagementSource PSGallery
    {
        Ensure      = "Present"
        Name        = "psgallery"
        ProviderName= "PowerShellGet"
        SourceLocation   = "https://www.powershellgallery.com/api/v2"
        InstallationPolicy ="Trusted"
    }

    PackageManagement NugetPackage
    {
        Ensure               = "Present"
        Name                 = "JQuery"
        AdditionalParameters = "$env:HomeDrive\nuget"
        RequiredVersion      = "2.0.1"
        DependsOn            = "[PackageManagementSource]SourceRepository"
    }

    PackageManagement PSModule
    {
        Ensure               = "Present"
        Name                 = "gistprovider"
        Source               = "PSGallery"
        DependsOn            = "[PackageManagementSource]PSGallery"
    }
}