Delen via

Find-Script

Module:
PowerShellGet v3 Module

Hiermee zoekt u een script.

Syntaxis

Default (Standaard) 

Find-Script
    [[-Name] <String[]>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-IncludeDependencies]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-Command <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AllowPrerelease]
    [<CommonParameters>]

Description

De Find-Script cmdlet zoekt een opgegeven script 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 script zoeken op naam

Find-Script -Name "Start-WFContosoServer"

Met deze opdracht wordt het script met de naam Start-WFContosoServergevonden.

Voorbeeld 2: Een script zoeken op naam, vereiste versie en vanuit een opgegeven opslagplaats

Find-Script -Name "Required-Script2" -RequiredVersion 2.0 -Repository "LocalRepo01"

Met deze opdracht wordt een script op naam en vereiste versie gevonden in de opslagplaats LocalRepo01.

Voorbeeld 3: Een script zoeken in het opgegeven versiebereik

Find-Script -Name "Required-Script2" -MinimumVersion 2.1 -MaximumVersion 2.5 -Repository "LocalRepo1"
Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Met deze opdracht vindt u alle versies van RequiredScript2 tussen versie 2.1 en 2.5 in de LocalRepo1-respository.

Voorbeeld 4: Alle versies van een script zoeken

Find-Script -Name "Required-Script02" -AllVersions

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
1.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
2.0        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Met deze opdracht worden alle versies van Required-Script02 gevonden.

Voorbeeld 5: Een script en de bijbehorende afhankelijkheden zoeken

Find-Script -Name "Script-WithDependencies1" -IncludeDependencies -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Script-WithDependencies1            Script     LocalRepo1           Description for the Script-WithDependencies1 script
2.0        RequiredModule3                     Script     LocalRepo1           RequiredModule3 module
2.5        Required-Script1                    Script     LocalRepo1           Description for the Required-Script1 script
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Met deze opdracht vindt u een script en de bijbehorende afhankelijkheden.

Voorbeeld 6: Scripts zoeken met de opgegeven tag

Find-Script -Tag "Tag1" -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Fabrikam-ClientScript               Script     LocalRepo1           Description for the Fabrikam-ClientScript script

Met deze opdracht vindt u scripts met de tag Tag1 in de opslagplaats LocalRepo1

Voorbeeld 7: Scripts zoeken met de opgegeven opdrachtnaam

Find-Script -Command Test-FunctionFromScript_Required-Script3 -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script3                    Script     LocalRepo1           Description for the Required-Script3 script

Met deze opdracht wordt een script gevonden dat de opgegeven opdrachtnaam bevat.

Voorbeeld 8: Scripts zoeken met jokertekens

Find-Script -Name "Required-Script*" -Repository "LocalRepo1"
Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script1                    Script     local1               Description for the Required-Script1 script
2.5        Required-Script2                    Script     local1               Description for the Required-Script2 script
2.5        Required-Script3                    Script     local1               Description for the Required-Script3 script

Met deze opdracht wordt het jokerteken (*) gebruikt om scripts te vinden die beginnen met Required-Script.

Parameters

-AllowPrerelease

Bevat de resultatenscripts die zijn gemarkeerd als een voorlopige versie.

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AllVersions

Geeft aan dat met deze bewerking alle scriptversies worden gevonden.

De proxy-cmdlet transformeert deze parameter naar -Version * voordat u aanroept Find-PSResource.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Command

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Credential

Hiermee geeft u een gebruikersaccount op die gemachtigd is om toegang te krijgen tot de opslagplaats om naar scripts te zoeken.

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Filter

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeDependencies

Geeft aan dat deze bewerking alle scripts ophaalt die afhankelijk zijn van het script dat is opgegeven in de parameter Naam .

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Includes

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

Parametereigenschappen

Type:

String[]

Default value:None
Geaccepteerde waarden:Function, Workflow
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MaximumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor NuGet-versies te maken voor gebruik met de parameter Versie van Find-PSResource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-MinimumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor NuGet-versies te maken voor gebruik met de parameter Versie van Find-PSResource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u een matrix van namen van scripts te vinden.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Proxy

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

Parametereigenschappen

Type:Uri
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ProxyCredential

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

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Repository

Hiermee geeft u de beschrijvende naam van een opslagplaats die is geregistreerd door uit te voeren Register-PSRepository.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RequiredVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor NuGet-versies te maken voor gebruik met de parameter Versie van Find-PSResource.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Tag

Hiermee specificeert u een reeks van tags.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

String

Uri

PSCredential

Uitvoerwaarden

PSRepositoryItemInfo

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