Dela via


Find-Command

Hittar PowerShell-kommandon i moduler.

Syntax

All

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 cmdleten Find-PSResource 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 kan 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 i pipelinen till Save-Module. Parametern Path avgör var modulen ska sparas. Utförliga ä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.

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AllVersions

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Filter

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MaximumVersion

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MinimumVersion

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ModuleName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Anger kommandonamnet som ska sökas 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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Proxy

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

Parameteregenskaper

Typ:Uri
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ProxyCredential

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

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Repository

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RequiredVersion

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Tag

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Utdata

PSGetCommandInfo

Find-Command matar ut ett PSGetCommandInfo--objekt.

Kommentarer

PowerShell-galleriet stöder inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att se till att du använder TLS 1.2:

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