Compartir a través de

Find-Command

  • Referencia
Módulo:
PowerShellGet

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                 PSGallery

Find-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