Freigeben über


Find-Script

Sucht nach einem Skript.

Syntax

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>]

Beschreibung

Das Find-Script Cmdlet sucht ein angegebenes Skript in registrierten Repositorys.

Dies ist ein Proxy-Cmdlet für das Find-PSResource Cmdlet in Microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Find-PSResource.

Beispiele

Beispiel 1: Suchen eines Skripts anhand des Namens

Find-Script -Name "Start-WFContosoServer"

Mit diesem Befehl wird das Skript mit dem Namen gefunden Start-WFContosoServer.

Beispiel 2: Suchen eines Skripts anhand des Namens, der erforderlichen Version und eines angegebenen Repositorys

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

Dieser Befehl sucht ein Skript anhand des Namens und der erforderlichen Version im Repository LocalRepo01.

Beispiel 3: Suchen eines Skripts im angegebenen Versionsbereich

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

Dieser Befehl sucht alle Versionen von RequiredScript2 zwischen den Versionen 2.1 und 2.5 im LocalRepo1-Respository.

Beispiel 4: Suchen aller Versionen eines Skripts

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

Mit diesem Befehl werden alle Versionen von Required-Script02 gefunden.

Beispiel 5: Suchen eines Skripts und seiner Abhängigkeiten

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

Dieser Befehl sucht nach einem Skript und dessen Abhängigkeiten.

Beispiel 6: Suchen nach Skripts mit dem angegebenen Tag

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

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

Mit diesem Befehl werden Skripts mit dem Tag Tag1 im LocalRepo1-Repository gefunden.

Beispiel 7: Suchen nach Skripts mit dem angegebenen Befehlsnamen

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

Dieser Befehl sucht nach einem Skript, das den angegebenen Befehlsnamen enthält.

Beispiel 8: Suchen von Skripts mithilfe von Wildcards

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

Dieser Befehl verwendet das Wildcardzeichen (*), um Skripts zu suchen, die mit Required-Script beginnen.

Parameter

-AllowPrerelease

Enthält in den Ergebnisskripts, die als Vorabversion gekennzeichnet sind.

Das Proxy-Cmdlet ordnet diesen Parameter dem Prerelease-Parameter von zu Find-PSResource.

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

-AllVersions

Gibt an, dass dieser Vorgang alle Skriptversionen findet.

Das Proxy-Cmdlet transformiert diesen Parameter in -Version * , bevor aufgerufen wird Find-PSResource.

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

-Command

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Credential

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

-Filter

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-IncludeDependencies

Gibt an, dass dieser Vorgang alle Skripts abruft, die von dem im Parameter Name angegebenen Skript abhängig sind.

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

-Includes

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

Type:String[]
Accepted values:Function, Workflow
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge zur Verwendung mit dem Versionsparameter von Find-PSResourcezu erstellen.

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

-MinimumVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge zur Verwendung mit dem Versionsparameter von Find-PSResourcezu erstellen.

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

-Name

Gibt ein Array von Namen von skripts an, die gesucht werden sollen.

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

-Proxy

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-ProxyCredential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Repository

Gibt den Anzeigenamen eines Repositorys an, das durch Ausführen Register-PSRepositoryvon registriert wurde.

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

-RequiredVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge zur Verwendung mit dem Versionsparameter von Find-PSResourcezu erstellen.

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

-Tag

Gibt ein Array von Tags an.

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

Eingaben

String[]

String

Uri

PSCredential

Ausgaben

PSRepositoryItemInfo

Hinweise

Die PowerShell-Katalog die TLS-Versionen 1.0 und 1.1 (Transport Layer Security) nicht mehr unterstützt. Sie müssen TLS 1.2 oder höher verwenden. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

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