Find-Script

Модуль:

PowerShellGet Module

Находит скрипт.

Синтаксис

Default (По умолчанию)

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

Описание

Командлет Find-Script находит указанный скрипт в зарегистрированных репозиториях.

Примеры

Пример 1. Поиск всех доступных скриптов

Find-Script

Эта команда находит все доступные скрипты.

Пример 2. Поиск скрипта по имени

Find-Script -Name "Start-WFContosoServer"

Эта команда находит скрипт с именем Start-WFContosoServer.

Пример 3. Поиск скрипта по имени, требуемой версии и из указанного репозитория

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

Эта команда находит скрипт по имени и требуемой версии в репозитории LocalRepo01.

Пример 4. Поиск скрипта и форматирование выходных данных в виде списка

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

Эта команда находит Required-Script2 в репозитории LocalRepo1, а затем передает полученный объект PSRepositoryItemInfo командлету Format-List .

Пример 5. Поиск скрипта в указанном диапазоне версий

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

Эта команда находит все версии RequiredScript2 между версиями 2.1 и 2.5 в respository LocalRepo1.

Пример 6. Поиск всех версий скрипта

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

Эта команда находит все версии Required-Script02.

Пример 7. Поиск скрипта и его зависимостей

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

Эта команда находит скрипт и его зависимости.

Пример 8. Поиск скриптов с указанным тегом

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

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

Эта команда находит скрипты с тегом Tag1 в репозитории LocalRepo1

Пример 9. Поиск скриптов с указанным именем команды

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

Эта команда находит скрипт, содержащий указанное имя команды.

Пример 10. Поиск скриптов с рабочими процессами

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

Эта команда находит скрипты рабочих процессов в репозитории LocalRepo1.

Пример 11. Поиск скриптов с помощью подстановочных знаков

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

Эта команда использует подстановочный знак (*) для поиска скриптов, начинающихся с обязательных сценариев.

Параметры

-AllowPrerelease

Включает в скрипты результатов, помеченные как предварительная версия.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-AllVersions

Указывает, что эта операция находит все версии скриптов.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Command

Задает массив команд для поиска в скриптах. Команда может быть функцией или рабочим процессом.

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Credential

Указывает учетную запись пользователя, которая имеет разрешение на доступ к репозиторию для поиска скриптов.

Свойства параметров

Тип:	PSCredential
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Filter

Находит скрипты на основе синтаксиса поиска для конкретного поставщика PackageManagement .

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-IncludeDependencies

Указывает, что эта операция получает все скрипты, зависящие от скрипта, указанного в параметре Name .

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Includes

Указывает тип скрипта для получения. Допустимые значения для этого параметра:

• Function
• Workflow

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Принимаемые значения:	Function, Workflow
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MaximumVersion

Указывает максимальную или последнюю версию скрипта для поиска. Параметры MaximumVersion и RequiredVersion являются взаимоисключающими; В одной команде нельзя использовать оба параметра.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-MinimumVersion

Указывает минимальную версию скрипта для поиска. Параметры MinimumVersion и RequiredVersion являются взаимоисключающими; В одной команде нельзя использовать оба параметра.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Name

Задает массив имен скриптов для поиска.

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	True
Не показывайте:	False

Наборы параметров

(All)

Позиция:	0
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Proxy

Указывает прокси-сервер для запроса, а не подключение непосредственно к интернет-ресурсу.

Свойства параметров

Тип:	Uri
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ProxyCredential

Указывает учетную запись пользователя, которая имеет разрешение на использование прокси-сервера, указанного параметром Proxy .

Свойства параметров

Тип:	PSCredential
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Repository

Указывает понятное имя репозитория, зарегистрированного с помощью запуска Register-PSRepository.

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-RequiredVersion

Указывает точный номер версии скрипта для поиска.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Tag

Задает массив тегов.

Свойства параметров

Тип:	String[]
Значение по умолчанию:	None
Поддержка подстановочных знаков:	False
Не показывайте:	False

Наборы параметров

(All)

Позиция:	Named
Обязательный:	False
Ценность воронки продаж:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входы

String

String

Uri

PSCredential

Выходы

PSRepositoryItemInfo

Примечания

Это важно

По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:

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

Дополнительные сведения см. в объявления в блоге PowerShell.

Ссылки по теме

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