Find-DscResource
Localiza recursos de 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
O Find-DscResource cmdlet pesquisa repositórios registrados para localizar recursos de DSC contidos em módulos. Por padrão Find-DscResource , pesquisa todos os repositórios registrados.
Este é um cmdlet proxy para o Find-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, consulte Find-PSResource.
Exemplos
Exemplo 1: Localizar um recurso DSC por nome
Find-DscResource localiza recursos DSC por 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 PSGalleryFind-DscResource usa o parâmetro Name para localizar a matriz especificada de recursos DSC.
Exemplo 2: 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 exibir 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-ModuleFind-DscResource usa o parâmetro Name para localizar o recurso chamado xWebsite. O objeto é enviado pelo pipeline para o Install-Module cmdlet . Install-Module instala o módulo xWebAdministration para o recurso.
Parâmetros
-AllowPrerelease
Inclui recursos marcados como pré-lançamento nos resultados.
O cmdlet proxy mapeia esse parâmetro para o parâmetro Prerelease de Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
O cmdlet proxy mapeia esse parâmetro para o parâmetro DscResourceName de Find-PSResource.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Especifica um repositório para pesquisar recursos. Use vírgulas para separar uma matriz de nomes de repositório.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
O cmdlet proxy ignora esse parâmetro, pois não tem suporte do DscResourceNameParameterSet de Find-PSResource.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Saídas
PSGetDscResourceInfo
Find-DscResource retorna um objeto PSGetDscResourceInfo .
Observações
O Galeria do PowerShell não dá mais suporte às versões 1.0 e 1.1 do Protocolo TLS.0 e 1.1. Você deve usar o TLS 1.2 ou superior. Use o seguinte comando para garantir que esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
