Dela via

Find-Command

  • Referens
Modul:
PowerShellGet

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 igenom moduler i registrerade lagringsplatser.

För varje kommando som hittas av Find-Commandreturneras ett PSGetCommandInfo-objekt . PSGetCommandInfo-objektet kan skickas ned i pipelinen till cmdleten Install-Module . Install-Module installerar modulen som innehåller kommandot .

Exempel

Exempel 1: Hitta alla kommandon på en angiven lagringsplats

Cmdleten Find-Command söker i en registrerad lagringsplats efter moduler.

Find-Command -Repository PSGallery | Select-Object -First 10

Name                                Version    ModuleName          Repository
----                                -------    ----------          ----------
Disable-AzureRmDataCollection       5.8.3      AzureRM.profile     PSGallery
Disable-AzureRmContextAutosave      5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmDataCollection        5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmContextAutosave       5.8.3      AzureRM.profile     PSGallery
Remove-AzureRmEnvironment           5.8.3      AzureRM.profile     PSGallery
Get-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Set-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Add-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Get-AzureRmSubscription             5.8.3      AzureRM.profile     PSGallery
Connect-AzureRmAccount              5.8.3      AzureRM.profile     PSGallery

Find-Command använder parametern Repository för att ange namnet på en registrerad lagringsplats. Objekten skickas nedåt i pipelinen. Select-Object tar emot objekten och använder parametern First för att visa de första 10 resultaten.

Exempel 2: 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 Name anger kommandot Get-TargetResource.

Exempel 3: 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 Module-Name . Annars kan moduler installeras som du inte vill installera.

PS> Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
    Install-Module

PS> 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åt i pipelinen till Install-Module och modulen installeras. När installationen är klar kan du använda Get-InstalledModule för att visa resultatet.

Exempel 4: Hitta ett kommando och spara modulen

PS> 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-ScriptAnalyzer på PSGallery-lagringsplatsen . Objektet skickas nedåt i 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 en förhandsversion i resultatet.

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

-AllVersions

Anger att denna cmdlet hämtar alla versioner av en modul.

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

-Filter

Hittar moduler baserat på PackageManagement-providerns söksyntax. Ange till exempel ord att söka efter i egenskaperna ModuleName och Description .

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

-MaximumVersion

Anger den maximala versionen av modulen som ska inkluderas i resultatet. Parametrarna MaximumVersion och RequiredVersion kan inte användas i samma kommando.

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

-MinimumVersion

Anger den lägsta versionen av modulen som ska inkluderas i resultatet. Parametrarna MinimumVersion och RequiredVersion kan inte användas i samma kommando.

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

-ModuleName

Anger namnet på en modul för att söka efter kommandon. Standardvärdet är alla moduler.

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

-Name

Anger det kommandonamn som ska sökas efter på en lagringsplats. Använd kommatecken för att avgränsa en matris med kommandonamn.

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

-Proxy

Anger en proxyserver för begäran i stället för en direktanslutning till Internetresursen.

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

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.

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

Anger vilken version av modulen som ska ingå i resultatet.

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

-Tag

Anger taggar som kategoriserar moduler i en lagringsplats. Använd kommatecken för att avgränsa en matris med taggar.

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 .