Dela via


Find-Command

Söker efter PowerShell-kommandon i moduler.

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

Cmdleten Find-Command hittar PowerShell-kommandon som cmdletar, alias, funktioner och arbetsflöden. Find-Command söker i moduler i registrerade lagringsplatser.

Det här är en proxy-cmdlet för Find-PSResource cmdleten i Microsoft.PowerShell.PSResourceGet. Mer information finns i Find-PSResource.

Exempel

Exempel 1: Hitta ett kommando efter namn

Find-Command kan använda namnet på ett kommando för att hitta modulen på en lagringsplats. Det är möjligt att det finns ett kommandonamn i flera 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 använder parametern Repository för att söka i PSGallery. Parametern Namn anger kommandot Get-TargetResource.

Exempel 2: Hitta kommandon efter namn och installera modulen

Find-Command kan hitta kommandot och modulen och sedan skicka objektet till Install-Module. Om ett kommando ingår i flera moduler använder du parametern Find-Command cmdlets ModuleName . Annars kanske moduler installeras som du inte vill installera.

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 använder parametern Namn för att ange kommandot Get-TargetResource. Parametern Repository söker i PSGallery. Parametern ModuleName anger den modul som du vill installera , SystemLocaleDsc. Objektet skickas ned pipelinen till Install-Module och modulen installeras. När installationen är klar kan du använda Get-InstalledModule för att visa resultatet.

Exempel 3: Hitta ett kommando och spara modulen

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 använder parametrarna Namn och Lagringsplats för att söka efter kommandot Invoke-ScriptAnalyzerPSGallery-lagringsplatsen . Objektet skickas ned pipelinen till Save-Module. Parametern Path avgör var modulen ska sparas. Utförlig är en valfri parameter, men visar statusutdata i PowerShell-konsolen. Utförliga utdata är bra för felsökning.

Parametrar

-AllowPrerelease

Innehåller moduler som markerats som förhandsversioner i resultatet.

Proxy-cmdleten mappar den här parametern till parametern Prerelease för Find-PSResource.

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

-AllVersions

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-Filter

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-MaximumVersion

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-MinimumVersion

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-ModuleName

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-Name

Anger kommandonamnet som du vill söka efter på en lagringsplats. Använd kommatecken för att avgränsa en matris med kommandonamn.

Proxy-cmdleten mappar den här parametern till parametern CommandName för Find-PSResource.

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

-Proxy

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-ProxyCredential

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-Repository

Anger lagringsplatsen för att söka efter kommandon. Använd kommatecken för att avgränsa en matris med lagringsplatsnamn. Standardvärdet är alla lagringsplatser.

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

-RequiredVersion

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

-Tag

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av CommandNameParameterSet för Find-PSResource.

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

Utdata

PSGetCommandInfo

Find-Command matar ut ett PSGetCommandInfo-objekt .

Kommentarer

PowerShell-galleriet har inte längre stöd för TLS-versionerna 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att kontrollera att du använder TLS 1.2:

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