Condividi tramite

Find-Command

  • Riferimento
Modulo:
PowerShellGet

Trova i comandi di PowerShell nei moduli.

Sintassi

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

Descrizione

Il Find-Command cmdlet trova comandi di PowerShell, ad esempio cmdlet, alias, funzioni e flussi di lavoro. Find-Command cerca i moduli nei repository registrati.

Questo è un cmdlet proxy per il Find-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Find-PSResource.

Esempio

Esempio 1: Trovare un comando in base al nome

Find-Command può usare il nome di un comando per individuare il modulo in un repository. È possibile che un nome di comando esista in più 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 il parametro Repository per eseguire ricerche in PSGallery. Il parametro Name specifica il comando Get-TargetResource.

Esempio 2: Trovare i comandi in base al nome e installare il modulo

Find-Command può individuare il comando e il modulo, quindi inviare l'oggetto a Install-Module. Se un comando è incluso in più moduli, usare il Find-Command parametro ModuleName dei cmdlet. In caso contrario, i moduli potrebbero essere installati che non si desidera installare.

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 il parametro Name per specificare il comando Get-TargetResource. Il parametro Repository esegue la ricerca in PSGallery. Il parametro ModuleName specifica il modulo che si vuole installare, SystemLocaleDsc. L'oggetto viene inviato alla pipeline Install-Module e il modulo viene installato. Al termine dell'installazione, è possibile usare Get-InstalledModule per visualizzare i risultati.

Esempio 3: Trovare un comando e salvare il relativo modulo

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 i parametri Nome e Repository per cercare il comando Invoke-ScriptAnalyzer nel repository PSGallery . L'oggetto viene inviato alla pipeline a Save-Module. Il parametro Path determina la posizione per salvare il modulo. Verbose è un parametro facoltativo, ma visualizza l'output dello stato nella console di PowerShell. L'output dettagliato è utile per la risoluzione dei problemi.

Parametri

-AllowPrerelease

Include i moduli contrassegnati come versione preliminare nei risultati.

Il cmdlet proxy esegue il mapping di questo parametro al parametro Prerelease di Find-PSResource.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome del comando da cercare in un repository. Usare virgole per separare una matrice di nomi di comandi.

Il cmdlet proxy esegue il mapping di questo parametro al parametro CommandName di Find-PSResource.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Specifica il repository per cercare i comandi. Usare virgole per separare una matrice di nomi di repository. Il valore predefinito è tutti i repository.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Il cmdlet proxy ignora questo parametro perché non è supportato da CommandNameParameterSet di Find-PSResource.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Output

PSGetCommandInfo

Find-Command restituisce un oggetto PSGetCommandInfo .

Note

La PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Per verificare di usare TLS 1.2, eseguire il comando seguente:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12