Find-DscResource
Localiza recursos de Configuração de Estado Desejado (DSC).
Sintaxe
All
Find-DscResource
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <Version>]
[-RequiredVersion <Version>]
[-AllVersions]
[-Tag <String[]>]
[-Filter <String>]
[-Repository <String[]>]
[<CommonParameters>]
Description
O cmdlet Find-DscResource pesquisa repositórios registrados para localizar recursos DSC contidos em módulos. Por padrãoFind-DscResource pesquisa todos os repositórios registrados.
Para cada módulo encontrado por Find-DscResource, um objeto PSGetDscResourceInfo é retornado.
objetos de PSGetDscResourceInfo podem ser enviados pelo pipeline para o cmdlet Install-Module.
Install-Module instala o módulo.
Exemplos
Exemplo 1: Localizar todos os recursos do DSC
Find-DscResource retorna recursos DSC de repositórios registrados. Para pesquisar um repositório específico, use o parâmetro 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
Exemplo 2: Localizar um recurso DSC pelo nome
Find-DscResource localiza recursos DSC pelo nome. Use vírgulas para separar uma matriz de nomes de recursos.
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 usa o parâmetro Name para localizar a matriz especificada de recursos DSC.
Exemplo 3: Localizar um recurso DSC e instalá-lo
Find-DscResource localiza um recurso DSC e envia o objeto pelo pipeline a ser instalado.
Após a instalação, use Get-InstalledModule para visualizar os resultados.
Vários recursos do mesmo módulo podem ser enviados pelo pipeline para o Install-Module.
Install-Module tenta instalar o módulo apenas uma vez.
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource usa o parâmetro Name para localizar o recurso chamado xWebsite. O objeto é enviado pelo pipeline para o cmdlet Install-Module.
Install-Module instala o módulo xWebAdministration para o recurso.
Exemplo 4: Localizar todos os recursos DSC em um módulo
Find-DscResource localiza todos os recursos DSC contidos em um módulo especificado. Por padrão, a versão atual é exibida. Para exibir outras versões, use os parâmetros AllVersions ou 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 usa o parâmetro ModuleName para especificar o xWebAdministration e localizar os recursos DSC contidos no módulo. A versão atual de cada recurso é exibida.
Exemplo 5: Localizar um recurso DSC por tag e versão necessária
Os recursos DSC podem ser localizados usando os parâmetros Tag e RequiredVersion. Tag exibe a versão atual de cada recurso que contém a tag especificada no repositório. RequiredVersion precisa do parâmetro ModuleName e o parâmetro Name é opcional. Os parâmetros Name e ModuleName limitam a saída. Use o parâmetro AllVersions para exibir as versões disponíveis de um recurso 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
Exemplo 6: Localizar um recurso usando um filtro
Find-DscResource localiza todos os recursos e usa o parâmetro Filter para especificar os resultados por Domain. O parâmetro Filter localiza o valor do filtro na descrição do objeto ou no nome do módulo. Use o cmdlet Select-Object para exibir as propriedades de um objeto.
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
Parâmetros
-AllVersions
O parâmetro AllVersions exibe cada uma das versões disponíveis de um recurso DSC. Não é possível usar o parâmetro AllVersions com os parâmetros MinimumVersion, MaximumVersionou RequiredVersion.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Filter
Localiza recursos com base na sintaxe de pesquisa do provedor de
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-MinimumVersion
Especifica a versão mínima do recurso a ser incluída nos resultados. Os parâmetros MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
| Tipo: | Version |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Versão |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ModuleName
Especifica um módulo que contém o recurso DSC.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome de um recurso. O padrão é todos os recursos. Use vírgulas para separar uma matriz de nomes de recursos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Repository
Especifica um repositório para procurar recursos. Use vírgulas para separar uma matriz de nomes de repositório.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RequiredVersion
Especifica o número exato da versão do módulo a ser incluído nos resultados. Os parâmetros RequiredVersion e MinimumVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
| Tipo: | Version |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Tag
Especifica tags que categorizam módulos em um repositório. Use vírgulas para separar uma matriz de tags.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.