Find-DscResource
尋找 Desired State Configuration （DSC） 資源。
語法
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 會搜尋已註冊的存放庫，以尋找模組中包含的 DSC 資源。 根據預設，Find-DscResource 會搜尋所有已註冊的存放庫。
這是 Find-PSResource 中 Cmdlet 的 Proxy Cmdlet。 如需詳細資訊，請參閱 Find-PSResource。
範例
範例 1：依名稱尋找 DSC 資源
Find-DscResource 依名稱找出 DSC 資源。 使用逗號分隔資源名稱的陣列。
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 會使用 Name 參數來尋找指定的 DSC 資源陣列。
範例 2：尋找 DSC 資源並加以安裝
Find-DscResource 找出 DSC 資源，並將物件傳送至要安裝的管線。
安裝之後，請使用 Get-InstalledModule 來檢視結果。
從相同模組的多個資源可以將管線向下傳送至 Install-Module。
Install-Module 嘗試只安裝模組一次。
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource 會使用 Name 參數來尋找名為 xWebsite的資源。 物件會向下傳送至 Install-Module Cmdlet。
Install-Module 會安裝資源的 xWebAdministration 模組。
參數
-AllowPrerelease
在結果中包含標示為發行前版本的資源。
Proxy Cmdlet 會將此參數對應至 的Find-PSResource參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AllVersions
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaximumVersion
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MinimumVersion
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ModuleName
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定資源的名稱。 預設值為所有資源。 使用逗號分隔資源名稱的陣列。
Proxy Cmdlet 會將此參數對應至 的 Find-PSResource 參數。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Proxy
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | Uri |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ProxyCredential
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Repository
指定要搜尋資源的存放庫。 使用逗號分隔存放庫名稱的陣列。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RequiredVersion
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Tag
Proxy Cmdlet 會忽略此參數，因為 DscResourceNameParameterSetFind-PSResource不支援此參數。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
PSGetDscResourceInfo
Find-DscResource 會傳回 PSGetDscResourceInfo 物件。
備註
PowerShell 資源庫不再支援傳輸層安全性 （TLS） 1.0 和 1.1 版。 您必須使用 TLS 1.2 或更高版本。 使用下列命令以確保您使用 TLS 1.2：
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
