Find-Command
Busca comandos de PowerShell en módulos.
Syntax
Find-Command
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-AllVersions]
[-AllowPrerelease]
[-Tag <String[]>]
[-Filter <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Repository <String[]>]
[<CommonParameters>]Description
El Find-Command cmdlet busca comandos de PowerShell como cmdlets, alias, funciones y flujos de trabajo. Find-Command busca módulos en repositorios registrados.
Se trata de un cmdlet de proxy para el Find-PSResource cmdlet en Microsoft.PowerShell.PSResourceGet. Para obtener más información, consulte Find-PSResource.
Ejemplos
Ejemplo 1: Buscar un comando por nombre
Find-Command puede usar el nombre de un comando para buscar el módulo en un repositorio. Es posible que exista un nombre de comando en varios ModuleNames.
Find-Command -Repository PSGallery -Name Get-TargetResource
Name Version ModuleName Repository
---- ------- ---------- ----------
Get-TargetResource 3.1.0.0 xPowerShellExecutionPolicy PSGallery
Get-TargetResource 1.0.0 xInternetExplorerHomePage PSGallery
Get-TargetResource 1.2.0.0 SystemLocaleDsc PSGalleryFind-Command usa el parámetro Repository para buscar en PSGallery. El parámetro Name especifica el comando Get-TargetResource.
Ejemplo 2: Búsqueda de comandos por nombre e instalación del módulo
Find-Command puede buscar el comando y el módulo y, a continuación, enviar el objeto a Install-Module. Si se incluye un comando en varios módulos, use el Find-Command parámetro ModuleName de cmdlets.
De lo contrario, es posible que se instalen módulos que no desea instalar.
Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
Install-Module
Get-InstalledModule
Version Name Repository Description
------- ---- ---------- -----------
1.2.0.0 SystemLocaleDsc PSGallery This DSC Resource allows configuration of the Windows...Find-Command usa el parámetro Name para especificar el comando Get-TargetResource. El parámetro Repository busca en PSGallery. El parámetro ModuleName especifica el módulo que desea instalar, SystemLocaleDsc. El objeto se envía por la canalización a Install-Module y se instala el módulo. Una vez finalizada la instalación, puede usar Get-InstalledModule para mostrar los resultados.
Ejemplo 3: Buscar un comando y guardar su módulo
Find-Command -Name Invoke-ScriptAnalyzer -Repository PSGallery |
Save-Module -Path C:\Test\Modules -Verbose
VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'PSScriptAnalyzer'.
VERBOSE: Module 'PSScriptAnalyzer' was saved successfully to path 'C:\Test\Modules\PSScriptAnalyzer\1.18.0'.Find-Command usa los parámetros Name y Repository para buscar el comando Invoke-ScriptAnalyzer en el repositorio PSGallery . El objeto se envía por la canalización a Save-Module. El parámetro Path determina la ubicación para guardar el módulo. Verbose es un parámetro opcional, pero muestra la salida de estado en la consola de PowerShell. La salida detallada es beneficiosa para solucionar problemas.
Parámetros
-AllowPrerelease
Incluye módulos marcados como una versión preliminar en los resultados.
El cmdlet de proxy asigna este parámetro al parámetro versión preliminar de Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica el nombre del comando que se va a buscar en un repositorio. Use comas para separar una matriz de nombres de comando.
El cmdlet proxy asigna este parámetro al parámetro CommandName de Find-PSResource.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Especifica el repositorio que se va a buscar comandos. Use comas para separar una matriz de nombres de repositorio. El valor predeterminado es todos los repositorios.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
El cmdlet proxy omite este parámetro, ya que no es compatible con CommandNameParameterSet de Find-PSResource.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Salidas
PSGetCommandInfo
Find-Command genera un objeto PSGetCommandInfo .
Notas
El Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Debe usar TLS 1.2 o superior. Use el siguiente comando para asegurarse de que usa TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de