Find-DscResource

Menemukan sumber daya Desired State Configuration (DSC).

Sintaks

Find-DscResource
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Deskripsi

Find-DscResource Cmdlet mencari repositori terdaftar untuk menemukan sumber daya DSC yang terkandung dalam modul. Secara default Find-DscResource mencari semua repositori terdaftar.

Untuk setiap modul yang ditemukan oleh Find-DscResource, objek PSGetDscResourceInfo dikembalikan. Objek PSGetDscResourceInfo dapat dikirimkan alur ke Install-Module cmdlet . Install-Module menginstal modul.

Contoh

Contoh 1: Temukan semua sumber daya DSC

Find-DscResource mengembalikan sumber daya DSC dari repositori terdaftar. Untuk mencari repositori tertentu, gunakan parameter Repositori .

Find-DscResource

Name                           Version    ModuleName                     Repository
----                           -------    ----------                     ----------
Carbon_Privilege               2.8.1      Carbon                         PSGallery
Carbon_ScheduledTask           2.8.1      Carbon                         PSGallery
Carbon_Service                 2.8.1      Carbon                         PSGallery
PackageManagement              1.4        PackageManagement              PSGallery
PackageManagementSource        1.4        PackageManagement              PSGallery
PSModule                       2.1.4      PowerShellGet                  PSGallery
PSRepository                   2.1.4      PowerShellGet                  PSGallery
xArchive                       8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xDSCWebService                 8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xEnvironment                   8.7.0.0    xPSDesiredStateConfiguration   PSGallery

Contoh 2: Temukan sumber daya DSC berdasarkan nama

Find-DscResource menemukan sumber daya DSC berdasarkan nama. Gunakan koma untuk memisahkan array nama sumber daya.

Find-DscResource -Name xWebsite, xWebApplication, xWebSiteDefaults

Name               Version    ModuleName            Repository
----               -------    ----------            ----------
xWebApplication    2.6.0.0    xWebAdministration    PSGallery
xWebsite           2.6.0.0    xWebAdministration    PSGallery
xWebSiteDefaults   2.6.0.0    xWebAdministration    PSGallery

Find-DscResource menggunakan parameter Nama untuk menemukan array sumber daya DSC yang ditentukan.

Contoh 3: Temukan sumber daya DSC dan instal

Find-DscResource menemukan sumber daya DSC dan mengirim objek ke bawah alur yang akan diinstal. Setelah penginstalan, gunakan Get-InstalledModule untuk melihat hasilnya.

Beberapa sumber daya dari modul yang sama dapat dikirim ke alur ke Install-Module. Install-Module mencoba untuk hanya menginstal modul sekali.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource menggunakan parameter Nama untuk menemukan sumber daya bernama xWebsite. Objek dikirim ke alur ke Install-Module cmdlet. Install-Module menginstal modul xWebAdministration untuk sumber daya.

Contoh 4: Menemukan semua sumber daya DSC dalam modul

Find-DscResource menemukan semua sumber daya DSC yang terkandung dalam modul tertentu. Secara default, versi saat ini ditampilkan. Untuk menampilkan versi lain, gunakan parameter AllVersions atau RequiredVersions .

Find-DscResource -ModuleName xWebAdministration

Name                                Version    ModuleName              Repository
----                                -------    ----------              ----------
WebApplicationHandler               2.6.0.0    xWebAdministration      PSGallery
xIisFeatureDelegation               2.6.0.0    xWebAdministration      PSGallery
xIisHandler                         2.6.0.0    xWebAdministration      PSGallery
xIisLogging                         2.6.0.0    xWebAdministration      PSGallery

Find-DscResource menggunakan parameter ModuleName untuk menentukan xWebAdministration dan menemukan sumber daya DSC yang terkandung dalam modul. Versi saat ini dari setiap sumber daya ditampilkan.

Contoh 5: Temukan sumber daya DSC berdasarkan tag dan versi yang diperlukan

Sumber daya DSC dapat ditemukan menggunakan parameter Tag dan RequiredVersion. Tag menampilkan versi saat ini dari setiap sumber daya yang berisi tag yang ditentukan di repositori. RequiredVersion memerlukan parameter ModuleName dan parameter Nama bersifat opsional. Parameter Nama dan ModuleName membatasi output. Gunakan parameter AllVersions untuk menampilkan versi sumber daya DSC yang tersedia.

Find-DscResource -ModuleName xWebAdministration -Tag DSC -RequiredVersion 1.20

Name                    Version    ModuleName             Repository
----                    -------    ----------             ----------
xIisFeatureDelegation   1.20.0.0   xWebAdministration     PSGallery
xIisHandler             1.20.0.0   xWebAdministration     PSGallery
xIisLogging             1.20.0.0   xWebAdministration     PSGallery
xIisMimeTypeMapping     1.20.0.0   xWebAdministration     PSGallery

Contoh 6: Menemukan sumber daya dengan menggunakan filter

Find-DscResource menemukan semua sumber daya dan menggunakan parameter Filter untuk menentukan hasilnya menurut Domain. Parameter Filter menemukan nilai filter dalam deskripsi objek atau nama modul. Select-Object Gunakan cmdlet untuk melihat properti objek.

Find-DscResource -Filter Domain

Name                    Version    ModuleName                 Repository
----                    -------    ----------                 ---------
xComputer               4.1.0.0    xComputerManagement        PSGallery
Computer                6.4.0.0    ComputerManagementDsc      PSGallery
xDSCDomainjoin          1.1        xDSCDomainjoin             PSGallery
xDisk                   1.0        xDisk                      PSGallery
xDSCFirewall            1.6.21     xDSCFirewall               PSGallery
dmAwsTagInstance        1.0.1      domainAwsDSCResources      PSGallery

Parameter

-AllowPrerelease

Menyertakan sumber daya yang ditandai sebagai prarilis dalam hasil.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

Parameter AllVersions menampilkan masing-masing versi sumber daya DSC yang tersedia. Anda tidak dapat menggunakan parameter AllVersions dengan parameter MinimumVersion, MaximumVersion, atau RequiredVersion .

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Menemukan sumber daya berdasarkan sintaks pencarian penyedia PackageManagement . Misalnya, tentukan kata yang akan dicari dalam properti ModuleName dan Description .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Menentukan versi maksimum sumber daya untuk disertakan dalam hasil. Parameter MaximumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Menentukan versi minimum sumber daya untuk disertakan dalam hasil. Parameter MinimumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

Menentukan modul yang berisi sumber daya DSC.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama sumber daya. Defaultnya adalah semua sumber daya. Gunakan koma untuk memisahkan array nama sumber daya.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Menentukan server proksi untuk permintaan, bukan koneksi langsung ke sumber daya internet.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Menentukan akun pengguna dengan izin untuk menggunakan server proksi yang ditentukan dalam parameter Proksi .

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Menentukan repositori untuk mencari sumber daya. Gunakan koma untuk memisahkan array nama repositori.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

Menentukan nomor versi modul yang tepat untuk disertakan dalam hasilnya. Parameter RequiredVersion dan MinimumVersion tidak dapat digunakan dalam perintah yang sama.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Menentukan tag yang mengategorikan modul dalam repositori. Gunakan koma untuk memisahkan array tag.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Output

PSGetDscResourceInfo

Find-DscResource mengembalikan objek PSGetDscResourceInfo .

Catatan

Penting

Mulai April 2020, PowerShell Gallery tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Jika Anda tidak menggunakan TLS 1.2 atau yang lebih tinggi, Anda akan menerima kesalahan saat mencoba mengakses Galeri PowerShell. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Untuk informasi selengkapnya, lihat pengumuman di blog PowerShell.