Find-Script

Modul:

PowerShellGet Module

Hittar ett skript.

Syntax

Default (Standard)

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

Beskrivning

Cmdleten Find-Script hittar ett angivet skript i registrerade lagringsplatser.

Exempel

Exempel 1: Hitta alla tillgängliga skript

Find-Script

Det här kommandot hittar alla tillgängliga skript.

Exempel 2: Hitta ett skript efter namn

Find-Script -Name "Start-WFContosoServer"

Det här kommandot hittar skriptet med namnet Start-WFContosoServer.

Exempel 3: Hitta ett skript efter namn, nödvändig version och från en angiven lagringsplats

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

Det här kommandot hittar ett skript efter namn och nödvändig version på localrepo01-lagringsplatsen.

Exempel 4: Hitta ett skript och formatera utdata som en lista

Find-Script -Name "Required-Script2" -RequiredVersion 2.0 -Repository "LocalRepo1" | Format-List * -Force

Det här kommandot hittar Required-Script2 på lagringsplatsen LocalRepo1 och skickar sedan det resulterande PSRepositoryItemInfo-objektet till cmdleten Format-List .

Exempel 5: Hitta ett skript i det angivna versionsintervallet

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

Det här kommandot hittar alla versioner av RequiredScript2 mellan versionerna 2.1 och 2.5 i localrepo1-respository.

Exempel 6: Hitta alla versioner av ett skript

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

Det här kommandot hittar alla versioner av Required-Script02.

Exempel 7: Hitta ett skript och dess beroenden

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

Det här kommandot hittar ett skript och dess beroenden.

Exempel 8: Hitta skript med den angivna taggen

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

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

Det här kommandot hittar skript som har taggen Tag1 på LocalRepo1-lagringsplatsen

Exempel 9: Hitta skript med angivet kommandonamn

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

Det här kommandot hittar ett skript som innehåller det angivna kommandonamnet.

Exempel 10: Hitta skript med arbetsflöden

Find-Script -Includes "Workflow" -Repository "LocalRepo1"

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

Det här kommandot hittar arbetsflödesskript på localrepo1-lagringsplatsen.

Exempel 11: Hitta skript med jokertecken

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

Det här kommandot använder jokertecknet (*) för att hitta skript som börjar med Required-Script.

Parametrar

-AllowPrerelease

Innehåller i resultatskripten som markerats som en förhandsversion.

Egenskaper för parameter

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

Anger att den här åtgärden hittar alla skriptversioner.

Egenskaper för parameter

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

-Command

Anger en matris med kommandon som ska hittas i skript. Ett kommando kan vara en funktion eller ett arbetsflöde.

Egenskaper för parameter

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

-Credential

Anger ett användarkonto som har behörighet att komma åt databasen för att söka efter skript.

Egenskaper för parameter

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

-Filter

Söker efter skript baserat på providerspecifik söksyntax för PackageManagement .

Egenskaper för parameter

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

-IncludeDependencies

Anger att den här åtgärden hämtar alla skript som är beroende av skriptet som anges i parametern Namn .

Egenskaper för parameter

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

-Includes

Anger vilken typ av skript som ska hämtas. De godtagbara värdena för den här parametern är:

• Function
• Workflow

Egenskaper för parameter

Typ:	String[]
Standardvärde:	None
Godkända värden:	Function, Workflow
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

Anger den maximala eller senaste versionen av skriptet som ska hittas. Parametrarna MaximumVersion och RequiredVersion är ömsesidigt uteslutande. du kan inte använda båda parametrarna i samma kommando.

Egenskaper för parameter

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:	True
Värde från återstående argument:	False

-MinimumVersion

Anger den lägsta version av skriptet som ska hittas. Parametrarna MinimumVersion och RequiredVersion är ömsesidigt uteslutande. du kan inte använda båda parametrarna i samma kommando.

Egenskaper för parameter

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:	True
Värde från återstående argument:	False

-Name

Anger en matris med namn på skript som ska hittas.

Egenskaper för parameter

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

Parameteruppsättningar

(All)

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

-Proxy

Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.

Egenskaper för parameter

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

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

Egenskaper för parameter

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 det egna namnet på en lagringsplats som har registrerats genom att köra Register-PSRepository.

Egenskaper för parameter

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

Anger det exakta versionsnumret för skriptet som ska hittas.

Egenskaper för parameter

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:	True
Värde från återstående argument:	False

-Tag

Anger en matris med taggar.

Egenskaper för parameter

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.

Ingångar

String

String

Uri

PSCredential

Utgångar

PSRepositoryItemInfo

Anteckningar

Viktigt!

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:

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

Mer information finns i meddelande i PowerShell-bloggen.

Relaterade länkar

• Install-Script
• Publish-Script
• Save-Script
• Uninstall-Script
• Update-Script