Find-DscResourceFind-DscResource

Localiza Recursos de DSC nos módulos.Finds DSC Resources in modules.

DescriçãoDescription

O cmdlet Find-DscResource localiza recursos de DSC (Configuração de Estado Desejado) contidos em módulos que correspondam aos critérios especificados dos repositórios registrados.The Find-DscResource cmdlet finds Desired State Configuration (DSC) resources contained in modules that match the specified criteria from registered repositories. Para cada módulo que localiza, o cmdlet Find-DscResource retorna um objeto PSGetDscResourceInfo que você pode redirecionar para Install-Module para instalar os módulos que contêm os recursos que esse cmdlet retorna.For each module that this cmdlet finds, Find-DscResource returns a PSGetDscResourceInfo object that you can pipe to Install-Module to install the modules containing the resources that this cmdlet returns.

A DSC é uma nova plataforma de gerenciamento do Windows PowerShell que permite implantar e gerenciar dados de configuração para serviços de software e gerenciar o ambiente no qual esses serviços são executados.DSC is a new management platform in Windows PowerShell that enables deploying and managing configuration data for software services and managing the environment in which these services run.

Os Recursos de Configuração de Estado Desejado (DSC) fornecem os blocos de construção para uma configuração DSC.Desired State Configuration (DSC) Resources provide the building blocks for a DSC configuration. Um recurso expõe propriedades que podem ser configuradas (esquema) e contém as funções de script do PowerShell que o Gerenciador de Configurações Local (LCM) chama de "realizar".A resource exposes properties that can be configured (schema) and contains the PowerShell script functions that the Local Configuration Manager (LCM) calls to "make it so".

Um recurso pode modelar algo tão genérico quanto um arquivo ou tão específico quanto uma configuração de servidor do IIS.A resource can model something as generic as a file or as specific as an IIS server setting. Grupos de recursos semelhantes são combinados em um Módulo de DSC, que organiza todos os arquivos necessários em uma estrutura que é portátil e inclui metadados para identificar como os recursos devem ser usados.Groups of like resources are combined in to a DSC Module, which organizes all the required files in to a structure that is portable and includes metadata to identify how the resources are intended to be used.

  • Find-DscResource pode filtrar segundo os parâmetros de versão: MinimumVersion, RequiredVersion, AllVersions.Find-DscResource can filter with version parameters: MinimumVersion, RequiredVersion, AllVersions.
    • Esses parâmetros são mutuamente exclusivos.These parameters are mutually exclusive.
    • Esses parâmetros de versão são permitidos apenas com o nome exclusivo do módulo, sem curingas.These version parameters are allowed only with the single module name without any wildcards.
    • Se o parâmetro RequiredVersion não for especificado, Find-DscResource retorna a versão mais recente do módulo que for igual ou maior que a versão mínima especificada ou a versão mais recente do módulo se nenhuma versão mínima tiver sido especificada.If the RequiredVersion parameter is not specified, Find-DscResource returns the latest version of the module that is equal to or greater than the minimum version specified or the latest version of the module if no minimum version is specified.
    • Se o parâmetro RequiredVersion for especificado, Find-DscResource retornará apenas a versão do módulo que corresponde exatamente à versão especificada.If the RequiredVersion parameter is specified, Find-DscResource only returns the version of the module that exactly matches the specified version.
  • Find-DscResource pode filtrar nos metadados do módulo com o parâmetro -TagFind-DscResource can filter on module metadata with the -Tag parameter
  • Find-DscResource pode filtrar na linguagem de pesquisa específica do repositório com o parâmetro -Filter.Find-DscResource can filter on repository-specific search language with the -Filter parameter.
  • Find-DscResource pode filtrar módulos de todos ou de alguns dos repositórios registrados.Find-DscResource can filter on modules from all or few of the registered repositories.

Sintaxe do cmdletCmdlet syntax

Get-Command -Name Find-DscResource -Module PowerShellGet -Syntax

Referência da ajuda online sobre cmdletsCmdlet online help reference

Find-DscResourceFind-DscResource

Comandos de exemploExample commands


# Find a specific DSC Resource
Find-DscResource -Name xIisFeatureDelegation

Name                                Version    ModuleName                          Repository
----                                -------    ----------                          ----------
xIisFeatureDelegation               1.10.0.0   xWebAdministration                  PSGallery

# Find all available DSC Resources from all registered repositories
Find-DscResource

# Find a DSC resource by name
Find-DscResource -Name xWebsite

# Find multiple DSC Resources
Find-DscResource -Name xIisHandler, xFirewall

# Find all DSC resources contained within a specific module
Find-DscResource -ModuleName xNetworking
Find-DscResource -ModuleName xWebAdministration

# Find all DSC resources in modules with DSCResourceKit or DesiredStateConfiguration
Find-DscResource -Tag DesiredStateConfiguration, DSCResourceKit

# Find available DSC Resources from few registered repositories
Find-DscResource -Repository PSGallery,PrivatePSGallery

# Find all DSC Resources in a specified repository
Find-DscResource -Repository PSGallery

# Find DSC Resources from all versions of a module
Find-DscResource -ModuleName xNetworking -AllVersions

# Find DSC Resources with module name and MinimumVersion.
Find-DscResource -ModuleName xNetworking -MinimumVersion 1.1

# Find DSC Resources with module name and exact version
Find-DscResource -ModuleName xNetworking -RequiredVersion 2.1.1

# Find DSC Resources defined modules with -Filter based search. -Filter searches in description and module names
Find-DscResource -Filter Domain

# Find all DSC Resources with tags Azure or DSC in module metadata
Find-DscResource -Tag Azure, DSC