Find-DscResource

Başvuru

Modül:: PowerShellGet

Desired State Configuration (DSC) kaynaklarını bulur.

Syntax

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

Description

Cmdlet, Find-DscResource modüllerde bulunan DSC kaynaklarını bulmak için kayıtlı depoları arar. Varsayılan olarak Find-DscResource tüm kayıtlı depoları arar.

tarafından Find-DscResourcebulunan her modül için bir PSGetDscResourceInfo nesnesi döndürülür. PSGetDscResourceInfo nesneleri işlem hattına cmdlet'ine Install-Module gönderilebilir. Install-Module modülü yükler.

Örnekler

Örnek 1: Tüm DSC kaynaklarını bulma

Find-DscResource kayıtlı depolardan DSC kaynaklarını döndürür. Belirli bir depoda arama yapmak için Repository parametresini kullanın.

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

Örnek 2: Ada göre bir DSC kaynağı bulma

Find-DscResource DSC kaynaklarını ada göre bulur. Kaynak adları dizisini ayırmak için virgül kullanın.

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 belirtilen DSC kaynakları dizisini bulmak için Name parametresini kullanır.

Örnek 3: DSC kaynağını bulma ve yükleme

Find-DscResource bir DSC kaynağını bulur ve nesneyi yüklenecek işlem hattına gönderir. Yüklemeden sonra, sonuçları görüntülemek için kullanın Get-InstalledModule .

Aynı modüldeki birden çok kaynak işlem hattına Install-Modulegönderilebilir. Install-Module modülü yalnızca bir kez yüklemeye çalışır.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResourcexWebsite adlı kaynağı bulmak için Name parametresini kullanır. nesnesi işlem hattına cmdlet'ine Install-Module gönderilir. Install-Module kaynağın xWebAdministration modülünü yükler.

Örnek 4: Modüldeki tüm DSC kaynaklarını bulma

Find-DscResource belirtilen modülde yer alan tüm DSC kaynaklarını bulur. Varsayılan olarak geçerli sürüm görüntülenir. Diğer sürümleri görüntülemek için AllVersions veya RequiredVersions parametrelerini kullanın.

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-DscResourcexWebAdministration değerini belirtmek ve modülde yer alan DSC kaynaklarını bulmak için ModuleName parametresini kullanır. Her kaynağın geçerli sürümü görüntülenir.

Örnek 5: Etikete ve gerekli sürüme göre bir DSC kaynağı bulma

DSC kaynakları Tag ve RequiredVersion parametreleri kullanılarak bulunabilir. Tag , depoda belirtilen etiketi içeren her kaynağın geçerli sürümünü görüntüler. RequiredVersioniçin ModuleName parametresi gerekir ve Name parametresi isteğe bağlıdır. Name ve ModuleName parametreleri çıkışı sınırlar. DSC kaynağının kullanılabilir sürümlerini görüntülemek için AllVersions parametresini kullanın.

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

Örnek 6: Filtre kullanarak kaynak bulma

Find-DscResourcetüm kaynakları bulur ve Sonuçları Etki Alanına göre belirtmek için Filter parametresini kullanır. Filter parametresi nesnenin açıklamasındaki veya modül adındaki filtre değerini bulur. Bir nesnenin Select-Object özelliklerini görüntülemek için cmdlet'ini kullanın.

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

Parametreler

-AllowPrerelease

Ön sürüm olarak işaretlenmiş kaynakları sonuçlara ekler.

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

-AllVersions

AllVersions parametresi bir DSC kaynağının kullanılabilir sürümlerinin her birini görüntüler. AllVersions parametresini MinimumVersion, MaximumVersion veya RequiredVersion parametreleriyle kullanamazsınız.

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

-Filter

PackageManagement sağlayıcısının arama söz dizimine göre kaynakları bulur. Örneğin ModuleName ve Description özelliklerinde aranacak sözcükleri belirtin.

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

-MaximumVersion

Kaynağın sonuçlara eklenecek en yüksek sürümünü belirtir. MaximumVersion ve RequiredVersion parametreleri aynı komutta kullanılamaz.

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

-MinimumVersion

Kaynağın sonuçlara dahil etmek için en düşük sürümünü belirtir. MinimumVersion ve RequiredVersion parametreleri aynı komutta kullanılamaz.

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

-ModuleName

DSC kaynağını içeren bir modülü belirtir.

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

-Name

Kaynağın adını belirtir. Varsayılan değer tüm kaynaklardır. Kaynak adları dizisini ayırmak için virgül kullanın.

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

-Proxy

İnternet kaynağına doğrudan bağlantı yerine istek için bir proxy sunucusu belirtir.

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

-ProxyCredential

Proxy parametresinde belirtilen proxy sunucusunu kullanma iznine sahip bir kullanıcı hesabı belirtir.

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

-Repository

Kaynakları aramak için bir depo belirtir. Depo adları dizisini ayırmak için virgül kullanın.

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

-RequiredVersion

Sonuçlara dahil etmek için modülün tam sürüm numarasını belirtir. RequiredVersion ve MinimumVersion parametreleri aynı komutta kullanılamaz.

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

-Tag

Depodaki modülleri kategorilere ayıran etiketleri belirtir. Bir etiket dizisini ayırmak için virgül kullanın.

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

Çıkışlar

PSGetDscResourceInfo

Find-DscResourcebir PSGetDscResourceInfo nesnesi döndürür.

Notlar

Önemli

Nisan 2020 itibarıyla PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmıyorsanız, PowerShell Galerisi erişmeye çalışırken bir hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

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

Daha fazla bilgi için PowerShell blogundaki duyuruya bakın.

Aracılığıyla paylaş

Find-DscResource

Syntax

Description

Örnekler

Örnek 1: Tüm DSC kaynaklarını bulma

Örnek 2: Ada göre bir DSC kaynağı bulma

Örnek 3: DSC kaynağını bulma ve yükleme

Örnek 4: Modüldeki tüm DSC kaynaklarını bulma

Örnek 5: Etikete ve gerekli sürüme göre bir DSC kaynağı bulma

Örnek 6: Filtre kullanarak kaynak bulma

Parametreler

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Find-DscResource

Syntax

Description

Örnekler

Örnek 1: Tüm DSC kaynaklarını bulma

Örnek 2: Ada göre bir DSC kaynağı bulma

Örnek 3: DSC kaynağını bulma ve yükleme

Örnek 4: Modüldeki tüm DSC kaynaklarını bulma

Örnek 5: Etikete ve gerekli sürüme göre bir DSC kaynağı bulma

Örnek 6: Filtre kullanarak kaynak bulma

Parametreler

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar