Find-DscResource
尋找 Desired State Configuration （DSC） 資源。
語法
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-DscResource找到的每個模組，會傳回 PSGetDscResourceInfo 物件。
PSGetDscResourceInfo 物件可以向下傳送至 Install-Module Cmdlet。
Install-Module 安裝模組。
範例
範例 1：尋找所有 DSC 資源
Find-DscResource 會從已註冊的存放庫傳回 DSC 資源。 若要搜尋特定存放庫，請使用 Repository 參數。
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：依名稱尋找 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 資源陣列。
範例 3：尋找 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 模組。
範例 4：尋找模組中的所有 DSC 資源
Find-DscResource 會尋找指定模組中包含的所有 DSC 資源。 根據預設，會顯示目前的版本。 若要顯示其他版本，請使用 AllVersions 或 RequiredVersions 參數。
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 會使用 ModuleName 參數來指定 xWebAdministration，並尋找模組中包含的 DSC 資源。 會顯示每個資源的目前版本。
範例 5：依標籤和必要版本尋找 DSC 資源
DSC 資源可以使用 tag 參數
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：使用篩選來尋找資源
Find-DscResource 會尋找所有資源，並使用 Filter 參數，Domain來指定結果。
Filter 參數會尋找物件描述或模組名稱中的篩選值。 使用 Select-Object Cmdlet 來檢視物件的屬性。
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參數
-AllowPrerelease
在結果中包含標示為發行前版本的資源。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AllVersions
AllVersions 參數會顯示每個 DSC 資源的可用版本。 您無法使用 AllVersions 參數搭配 MinimumVersion、MaximumVersion或 RequiredVersion 參數。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Filter
根據 PackageManagement 提供者的搜尋語法尋找資源。 例如，指定要在 ModuleName 內搜尋的字組，並 Description 屬性。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MaximumVersion
指定要包含在結果中的資源最大版本。 MaximumVersion 和 RequiredVersion 參數不能在同一個命令中使用。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MinimumVersion
指定要包含在結果中的資源最低版本。 MinimumVersion 和 RequiredVersion 參數不能在同一個命令中使用。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ModuleName
指定包含 DSC 資源的模組。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定資源的名稱。 預設值為所有資源。 使用逗號分隔資源名稱的陣列。
| 類型: | String[] |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Proxy
指定要求的 Proxy 伺服器，而不是直接連線到因特網資源。
| 類型: | Uri |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ProxyCredential
指定具有許可權的用戶帳戶，以使用 Proxy 參數中指定的 Proxy 伺服器。
| 類型: | PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Repository
指定要搜尋資源的存放庫。 使用逗號分隔存放庫名稱的陣列。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RequiredVersion
指定要包含在結果中的模組確切版本號碼。 RequiredVersion 和 MinimumVersion 參數不能在同一個命令中使用。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Tag
指定將存放庫中模組分類的標記。 使用逗號分隔標記陣列。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸出
PSGetDscResourceInfo
Find-DscResource 會傳回 PSGetDscResourceInfo 物件。
備註
重要
自 2020 年 4 月起，PowerShell 資源庫不再支援傳輸層安全性 （TLS） 1.0 和 1.1 版。 如果您未使用 TLS 1.2 或更高版本，當您嘗試存取 PowerShell 資源庫時，會收到錯誤。 使用下列命令以確保您使用 TLS 1.2：
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
如需詳細資訊，請參閱 PowerShell 部落格中的 公告。