Find-DscResource

Modul:

PowerShellGet Module

Menemukan sumber daya Konfigurasi Status yang Diinginkan (DSC).

Sintaks

All

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

cmdlet Find-DscResource 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 , objek PSGetDscResourceInfo dikembalikan. objek PSGetDscResourceInfo dapat dikirimkan alur ke cmdlet Install-Module. 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

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 dikirimkan alur ke Install-Module. Install-Module mencoba untuk hanya menginstal modul sekali.

Find-DscResource -Name xWebsite | Install-Module

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

Contoh 4: Temukan 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

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

menemukan semua sumber daya dan menggunakan parameter Filter untuk menentukan hasilnya menurutDomain . Parameter Filter menemukan nilai filter dalam deskripsi objek atau nama modul. Gunakan cmdlet Select-Object 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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 parameter.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Filter

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MaximumVersion

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MinimumVersion

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ModuleName

Menentukan modul yang berisi sumber daya DSC.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Name

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	0
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Proxy

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

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ProxyCredential

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

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Repository

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-RequiredVersion

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Tag

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Output

PSGetDscResourceInfo

mengembalikan objek PSGetDscResourceInfo .

Catatan

Penting

Pada April 2020, Galeri PowerShell 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.

Link Terkait

• Get-InstalledModule
• Install-Module
• Register-PSRepository
• Pilih-Objek
• Uninstall-Module