共用方式為

Find-DscResource

  • 參考
模組:
PowerShellGet

尋找DESIRED STATE CONFIGURATION (DSC) 資源。

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 搜尋已註冊的存放庫，以尋找模組中包含的 DSC 資源。 根據預設 Find-DscResource ，會搜尋所有已註冊的存放庫。

針對 找到 Find-DscResource 的每個模組，會傳回 PSGetDscResourceInfo 物件。 PSGetDscResourceInfo物件可以向下傳送至 Cmdlet。 Install-Module 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的資源。 物件會向下傳送至 Cmdlet 的 Install-Module 管線。 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 和 RequiredVersion參數找到。 標記 會顯示存放庫中包含指定標籤之每個資源的目前版本。 RequiredVersion 需要 ModuleName 參數， 而 Name 參數是選擇性的。 Name和ModuleName參數會限制輸出。 使用 AllVersions 參數來顯示 DSC 資源的可用版本。

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 參數依 網域指定結果。 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

在結果中包含標示為發行前版本的資源。

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

-AllVersions

AllVersions參數會顯示每個 DSC 資源的可用版本。 您無法搭配MinimumVersion、MaximumVersion或RequiredVersion參數使用AllVersions參數。

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

-Filter

根據 PackageManagement 提供者的搜尋語法尋找資源。 例如，指定要在 ModuleName 和 Description 屬性內搜尋的字組。

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

-MaximumVersion

指定要包含在結果中的資源最大版本。 MaximumVersion和RequiredVersion參數不能用於相同的命令中。

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

-MinimumVersion

指定要包含在結果中的資源最低版本。 MinimumVersion和RequiredVersion參數不能用在相同的命令中。

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

-ModuleName

指定包含 DSC 資源的模組。

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

-Name

指定資源的名稱。 預設值為所有資源。 使用逗號分隔資源名稱的陣列。

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

-Proxy

指定要求的 Proxy 伺服器，而不是直接連線到網際網路資源。

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

-ProxyCredential

指定具有許可權的使用者帳戶，以使用 Proxy 參數中指定的 Proxy 伺服器。

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

-Repository

指定要搜尋資源的存放庫。 使用逗號分隔存放庫名稱的陣列。

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

-RequiredVersion

指定要包含在結果中的模組確切版本號碼。 RequiredVersion和MinimumVersion參數不能用在相同的命令中。

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

-Tag

指定分類存放庫中模組的標記。 使用逗號分隔標記陣列。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 部落格中的公告 \(英文\)。