Bagikan melalui


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.

Ini adalah cmdlet proksi untuk Find-PSResource cmdlet di Microsoft.PowerShell.PSResourceGet. Untuk informasi selengkapnya, lihat Find-PSResource.

Contoh

Contoh 1: 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 2: 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.

Parameter

-AllowPrerelease

Menyertakan sumber daya yang ditandai sebagai prarilis dalam hasil.

Cmdlet proksi memetakan parameter ini ke parameter Prarilis dari Find-PSResource.

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

-AllVersions

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

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

-Filter

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

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

-MaximumVersion

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

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

-MinimumVersion

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

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

-ModuleName

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
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.

Cmdlet proksi memetakan parameter ini ke parameter DscResourceName dari Find-PSResource.

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

-Proxy

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

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

-ProxyCredential

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

Type:PSCredential
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

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

-Tag

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh DscResourceNameParameterSet dari Find-PSResource.

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

Output

PSGetDscResourceInfo

Find-DscResource mengembalikan objek PSGetDscResourceInfo .

Catatan

Galeri PowerShell tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Anda harus menggunakan TLS 1.2 atau yang lebih tinggi. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

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