Find-DscResource
Megkeresi a kívánt állapotkonfigurációs (DSC-) erőforrásokat.
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
A Find-DscResource parancsmag regisztrált adattárakban keres, hogy megtalálja a modulokban található DSC-erőforrásokat. Alapértelmezés szerint Find-DscResource az összes regisztrált adattárban keres.
Minden egyes talált Find-DscResourcemodulhoz egy PSGetDscResourceInfo objektum lesz visszaadva.
A PSGetDscResourceInfo objektumok elküldhetők a folyamaton a Install-Module parancsmagnak.
Install-Module telepíti a modult.
Példák
1. példa: Az összes DSC-erőforrás megkeresése
Find-DscResource DSC-erőforrásokat ad vissza a regisztrált tárházakból. Egy adott adattár kereséséhez használja az Adattár paramétert.
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
2. példa: DSC-erőforrás megkeresése név alapján
Find-DscResource név alapján megkeresi a DSC-erőforrásokat. Az erőforrásnevek tömbjének elválasztásához használjon vesszőket.
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 A Név paramétert használja a DSC-erőforrások megadott tömbjének megkereséséhez.
3. példa: DSC-erőforrás megkeresése és telepítése
Find-DscResource megkeres egy DSC-erőforrást, és elküldi az objektumot a telepíteni kívánt folyamatba.
A telepítés után az eredmények megtekintéséhez használja Get-InstalledModule .
Ugyanabból a modulból több erőforrás is elküldhető a folyamatba.Install-Module
Install-Module csak egyszer kísérli meg telepíteni a modult.
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource A Név paraméter használatával megkeresi az xWebsite nevű erőforrást. A rendszer elküldi az objektumot a folyamaton a Install-Module parancsmagnak.
Install-Module telepíti az xWebAdministration modult az erőforráshoz.
4. példa: Az összes DSC-erőforrás megkeresése egy modulban
Find-DscResource megkeresi a megadott modulban található összes DSC-erőforrást. Alapértelmezés szerint az aktuális verzió jelenik meg. Más verziók megjelenítéséhez használja az AllVersions vagy a RequiredVersions paramétereket.
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 A ModuleName paraméter használatával adja meg az xWebAdministration paramétert , és keresse meg a modulban található DSC-erőforrásokat. Megjelenik az egyes erőforrások aktuális verziója.
5. példa: DSC-erőforrás keresése címke és szükséges verzió szerint
A DSC-erőforrások a Tag és a RequiredVersion paraméterekkel helyezhetők el. A címke az adattárban a megadott címkét tartalmazó összes erőforrás aktuális verzióját jeleníti meg. A RequiredVersion-nak szüksége van a ModuleName paraméterre , a Név paraméter pedig nem kötelező. A Name és ModuleName paraméterek korlátozzák a kimenetet. Az AllVersions paraméterrel megjelenítheti egy DSC-erőforrás elérhető verzióit.
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
6. példa: Erőforrás keresése szűrővel
Find-DscResource megkeresi az összes erőforrást, és a Szűrő paraméter használatával adja meg az eredményeket tartomány szerint. A Szűrő paraméter megkeresi a szűrőértéket az objektum leírásában vagy modulnevében.
Select-Object A parancsmaggal megtekintheti egy objektum tulajdonságait.
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
Paraméterek
-AllowPrerelease
Az eredményekben előzetesként megjelölt erőforrásokat tartalmaz.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-AllVersions
Az AllVersions paraméter megjeleníti egy DSC-erőforrás elérhető verzióit. Az AllVersions paraméter nem használható a MinimumVersion, MaximumVersion vagy RequiredVersion paraméterekkel.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Filter
Megkeresi az erőforrásokat a PackageManagement szolgáltató keresési szintaxisa alapján. Adja meg például a ModuleName és a Description tulajdonságban keresni kívánt szavakat.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-MaximumVersion
Meghatározza, hogy az erőforrás maximális verziója szerepeljen az eredmények között. A MaximumVersion és a RequiredVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-MinimumVersion
Meghatározza, hogy az erőforrás minimális verziója szerepeljen az eredmények között. A MinimumVersion és a RequiredVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ModuleName
Megadja a DSC-erőforrást tartalmazó modult.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Egy erőforrás nevét adja meg. Az alapértelmezett érték az összes erőforrás. Az erőforrásnevek tömbjének elválasztásához használjon vesszőket.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Proxy
A kéréshez proxykiszolgálót ad meg, nem pedig az internetes erőforráshoz való közvetlen kapcsolatot.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ProxyCredential
Megadja a proxyparaméterben megadott proxykiszolgáló használatára vonatkozó engedéllyel rendelkező felhasználói fiókot.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Repository
Egy adattárat ad meg az erőforrások kereséséhez. Az adattárnevek tömbjének elválasztásához használjon vesszőket.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-RequiredVersion
Megadja a modul pontos verziószámát, amely szerepel az eredmények között. A RequiredVersion és a MinimumVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Tag
Olyan címkéket ad meg, amelyek kategorizálják a modulokat egy adattárban. Címkék tömbjének elválasztásához használjon vesszőt.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Kimenetek
PSGetDscResourceInfo
Find-DscResource
PSGetDscResourceInfo objektumot ad vissza.
Jegyzetek
Fontos
2020 áprilisától a PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2 vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-gyűjtemény elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
További információ: közlemény a PowerShell blogjában.