Bagikan melalui

Find-Script

  • Referensi
Modul:
PowerShellGet

Menemukan skrip.

Sintaks

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

Deskripsi

Find-Script Cmdlet menemukan skrip tertentu di repositori terdaftar.

Ini adalah cmdlet proksi untuk Find-PSResource cmdlet di Microsoft.PowerShell.PSResourceGet. Untuk informasi selengkapnya, lihat Find-PSResource.

Contoh

Contoh 1: Temukan skrip berdasarkan nama

Find-Script -Name "Start-WFContosoServer"

Perintah ini menemukan skrip bernama Start-WFContosoServer.

Contoh 2: Temukan skrip berdasarkan nama, versi yang diperlukan, dan dari repositori tertentu

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

Perintah ini menemukan skrip berdasarkan nama dan versi yang diperlukan di repositori LocalRepo01.

Contoh 3: Temukan skrip dalam rentang versi yang ditentukan

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

Perintah ini menemukan semua versi RequiredScript2 antara versi 2.1 dan 2.5 di respositori LocalRepo1.

Contoh 4: Temukan semua versi skrip

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

Perintah ini menemukan semua versi Required-Script02.

Contoh 5: Temukan skrip dan dependensinya

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

Perintah ini menemukan skrip dan dependensinya.

Contoh 6: Temukan skrip dengan tag yang ditentukan

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

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

Perintah ini menemukan skrip yang memiliki tag Tag1 di repositori LocalRepo1

Contoh 7: Temukan skrip dengan nama perintah yang ditentukan

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

Perintah ini menemukan skrip yang berisi nama perintah yang ditentukan.

Contoh 8: Menemukan skrip menggunakan kartubebas

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

Perintah ini menggunakan karakter kartubebas (*) untuk menemukan skrip yang dimulai dengan Required-Script.

Parameter

-AllowPrerelease

Termasuk dalam skrip hasil yang ditandai sebagai prarilis.

Cmdlet proksi memetakan parameter ini ke parameter Prarilis dari Find-PSResource.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-AllVersions

Menunjukkan bahwa operasi ini menemukan semua versi skrip.

Cmdlet proksi mengubah parameter ini menjadi -Version * sebelum memanggil Find-PSResource.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Command

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Credential

Jenis:PSCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Filter

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-IncludeDependencies

Menunjukkan bahwa operasi ini mendapatkan semua skrip yang bergantung pada skrip yang ditentukan dalam parameter Nama .

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Includes

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:String[]
Nilai yang diterima:Function, Workflow
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-MaximumVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Find-PSResource

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-MinimumVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Find-PSResource

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan array nama skrip yang akan ditemukan.

Jenis:String[]
Position:0
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:True

-Proxy

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:Uri
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ProxyCredential

Cmdlet proksi mengabaikan parameter ini karena tidak didukung oleh NameParameterSet dari Find-PSResource.

Jenis:PSCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Repository

Menentukan nama yang mudah diingat dari repositori yang telah didaftarkan dengan menjalankan Register-PSRepository.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-RequiredVersion

Cmdlet proksi menggunakan nilai parameter ini untuk membuat string pencarian versi NuGet untuk digunakan dengan parameter Versi .Find-PSResource

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Tag

Menentukan array tag.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String[]

String

Uri

PSCredential

Output

PSRepositoryItemInfo

Catatan

Galeri PowerShell tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Anda harus menggunakan TLS 1.2 atau yang lebih tinggi. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

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