Find-DscResource

Modül:

PowerShellGet Module

İstenen Durum Yapılandırması (DSC) kaynaklarını bulur.

Syntax

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

Description

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

Find-DscResourcetarafından bulunan her modül için bir PSGetDscResourceInfo nesnesi döndürülür. PSGetDscResourceInfo nesneleri işlem hattına Install-Module cmdlet'ine 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ğı bulur ve nesneyi yüklenecek işlem hattına gönderir. Yüklemeden sonra sonuçları görüntülemek için Get-InstalledModule kullanın.

aynı modüldeki birden çok kaynak işlem hattına Install-Modulegönderilebilir. Install-Module modülü yalnızca bir kez yüklemeyi dener.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource, xWebsiteadlı kaynağı bulmak için Name parametresini kullanır. Nesnesi, işlem hattı Install-Module cmdlet'ine gönderilir. Install-Module, kaynak için 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 kullanın veya RequiredVersions parametrelerini .

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, xWebAdministration 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 RequiredVersionparametreleri kullanılarak bulunabilir. Tag, depoda belirtilen etiketi içeren her kaynağın geçerli sürümünü görüntüler. RequiredVersionModuleName parametresine ihtiyaç duyar ve Adı parametresi isteğe bağlıdır. Adı 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

tüm kaynakları bulur ve sonuçları etki alanıbelirtmek için Filter parametresini kullanır. Filter parametresi nesnenin açıklamasındaki veya modül adındaki filtre değerini bulur. Nesnenin özelliklerini görüntülemek için Select-Object 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

Sonuçlara yayın öncesi olarak işaretlenmiş kaynakları içerir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AllVersions

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Filter

PackageManagement sağlayıcısının arama söz dizimine göre kaynakları bulur. Örneğin, ModuleName içinde aranacak sözcükleri belirtin ve Açıklama özellikleri .

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaximumVersion

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MinimumVersion

Sonuçlara eklenecek kaynağın en düşük sürümünü belirtir. MinimumVersion ve RequiredVersion parametreleri aynı komutta kullanılamaz.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ModuleName

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Proxy

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

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProxyCredential

Proxy parametresinde belirtilen ara sunucuyu kullanma iznine sahip bir kullanıcı hesabı belirtir.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Repository

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Tag

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Çıkışlar

PSGetDscResourceInfo

Find-DscResource bir 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'ne erişmeye çalışırken 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 blogunda duyuru bakın.

İlişkili Bağlantılar

• Get-InstalledModule
• Install-Module
• Register-PSRepository
• Nesne Seç
• Uninstall-Module