Delen via


Find-Command

Hiermee vindt u PowerShell-opdrachten in modules.

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

De Find-Command cmdlet vindt PowerShell-opdrachten, zoals cmdlets, aliassen, functies en werkstromen. Find-Command zoekt naar modules in geregistreerde opslagplaatsen.

Dit is een proxy-cmdlet voor de Find-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Find-PSResource voor meer informatie.

Voorbeelden

Voorbeeld 1: Een opdracht zoeken op naam

Find-Command kan de naam van een opdracht gebruiken om de module in een opslagplaats te vinden. Het is mogelijk dat een opdrachtnaam bestaat in meerdere 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 gebruikt de parameter Repository om in de PSGallery te zoeken. Met de parameter Name wordt de opdracht Get-TargetResourceopgegeven.

Voorbeeld 2: Opdrachten zoeken op naam en de module installeren

Find-Command kan de opdracht en module vinden en het object vervolgens verzenden naar Install-Module. Als een opdracht is opgenomen in meerdere modules, gebruikt u de Find-Command cmdlets ModuleName parameter. Anders kunnen modules worden geïnstalleerd die u niet wilde installeren.

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 gebruikt de parameter Name om de opdracht Get-TargetResourceop te geven. Met de parameter Repository wordt de PSGallery doorzocht. De parameter ModuleName geeft de module op die u wilt installeren, SystemLocaleDsc. Het object wordt door de pijplijn verzonden naar Install-Module en de module wordt geïnstalleerd. Nadat de installatie is voltooid, kunt u gebruiken Get-InstalledModule om de resultaten weer te geven.

Voorbeeld 3: Een opdracht zoeken en de module opslaan

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 gebruikt de parameters Naam en Opslagplaats om te zoeken naar de opdracht Invoke-ScriptAnalyzer in de PSGallery-opslagplaats . Het object wordt door de pijplijn verzonden naar Save-Module. De path-parameter bepaalt de locatie voor het opslaan van de module. Uitgebreid is een optionele parameter, maar geeft statusuitvoer weer in de PowerShell-console. De uitgebreide uitvoer is nuttig voor het oplossen van problemen.

Parameters

-AllowPrerelease

Bevat modules die zijn gemarkeerd als een voorlopige versie in de resultaten.

De proxy-cmdlet wijst deze parameter toe aan de prerelease-parameter van Find-PSResource.

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

-AllVersions

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-Filter

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-MaximumVersion

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-MinimumVersion

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-ModuleName

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-Name

Hiermee geeft u de opdrachtnaam te zoeken in een opslagplaats. Gebruik komma's om een matrix met opdrachtnamen van elkaar te scheiden.

De proxy-cmdlet wijst deze parameter toe aan de parameter CommandName van Find-PSResource.

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

-Proxy

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-ProxyCredential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-Repository

Hiermee geeft u de opslagplaats te zoeken naar opdrachten. Gebruik komma's om een matrix met opslagplaatsnamen van elkaar te scheiden. De standaardwaarde is alle opslagplaatsen.

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

-RequiredVersion

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

-Tag

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.

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

Uitvoerwaarden

PSGetCommandInfo

Find-Command voert een PSGetCommandInfo-object uit.

Notities

De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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