Find-RoleCapability

Ссылка

Модуль:: PowerShellGet

Находит возможности ролей в модулях.

Синтаксис

Find-RoleCapability
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Описание

Командлет Find-RoleCapability выполняет поиск зарегистрированных репозиториев, чтобы найти возможности и модули роли PowerShell.

Для каждой возможности роли, найденной с помощью Find-RoleCapability, возвращается объект PSGetRoleCapabilityInfo . Объекты PSGetRoleCapabilityInfo можно отправить в конвейер командлетам Install-Module или Save-Module .

Возможности ролей PowerShell определяют, какие команды и приложения доступны пользователю в конечной точке Just Enough Administration (JEA). Возможности роли определяются файлами с расширением .psrc .

Примеры

Пример 1. Поиск возможностей роли

Find-RoleCapability находит возможности роли в каждом зарегистрированном репозитории. Для поиска в определенном репозитории используйте параметр Repository .

Find-RoleCapability

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
General-Lev2     1.0        JeaExamples    PSGallery
IIS-Lev1         1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

Пример 2. Поиск возможностей роли по имени

Find-RoleCapability находит возможности роли по имени. Используйте запятые для разделения массива имен.

Find-RoleCapability -Name General-Lev1, IIS-Lev2

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

Пример 3. Поиск и сохранение модуля возможности роли

Командлет Find-RoleCapability находит возможность роли и отправляет объект вниз по конвейеру. Save-Module сохраняет модуль возможности роли в файловой системе. Get-ChildItem отображает содержимое каталога модуля.

PS> Find-RoleCapability -Name General-Lev1 | Save-Module -Path C:\Test\Modules

PS> Get-ChildItem -Path C:\Test\Modules\JeaExamples\1.0\

    Directory: C:\Test\Modules\JeaExamples\1.0

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----          6/4/2019    16:37                RoleCapabilities
-a----          2/5/2019    18:46           1702 CreateRegisterPSSC.ps1
-a----          2/5/2019    18:46           7656 JeaExamples.psd1
-a----         10/1/2018    08:16            595 JeaExamples.psm1

Find-RoleCapability использует параметр Name для указания возможности роли General-Lev1 . Объект отправляется вниз по конвейеру. Save-Module использует параметр Path для расположения файловой системы для сохранения модуля. После сохранения Get-ChildItem модуля указывает путь модуля и отображает содержимое каталога модуля JeaExamples .

Пример 4. Поиск и установка модуля возможности роли

Find-RoleCapability находит модуль и отправляет объект вниз по конвейеру. Install-Module устанавливает модуль . После установки используйте Get-InstalledModule для просмотра результатов.

Find-RoleCapability -Name General-Lev1 | Install-Module -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'JeaExamples'.
VERBOSE: InstallPackageLocal' - name='JeaExamples', version='1.0',
VERBOSE: Validating the 'JeaExamples' module contents
VERBOSE: Test-ModuleManifest successfully validated the module manifest file
VERBOSE: Module 'JeaExamples' was installed successfully to path

Get-InstalledModule

Find-RoleCapability использует параметр Name для указания возможности роли General-Lev1 . Объект отправляется вниз по конвейеру. Install-Module использует параметр Verbose для отображения сообщений о состоянии во время установки. После завершения установки выходные Get-InstalledModule данные подтверждают, что модуль JeaExamples установлен.

Параметры

-AllowPrerelease

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

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

-AllVersions

Указывает, что этот командлет получает все версии модуля. Параметр AllVersions отображает все доступные версии модуля.

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

-Filter

Находит ресурсы на основе синтаксиса поиска поставщика PackageManagement . Например, укажите слова для поиска в свойствах ModuleName и Description .

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-ModuleName

Указывает имя модуля, в котором выполняется поиск возможностей роли. Значение по умолчанию — все модули.

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

-Name

Указывает имя возможности роли. Значение по умолчанию — все возможности ролей. Используйте запятые для разделения массива имен ресурсов.

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

-Proxy

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

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

-ProxyCredential

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

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

-Repository

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

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

-RequiredVersion

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

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

-Tag

Указывает теги, которые классифицируют модули в репозитории. Используйте запятые для разделения массива тегов.

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

Входные данные

Uri

PSCredential

Выходные данные

PSGetRoleCapabilityInfo

Командлет Find-RoleCapability возвращает объект PSGetRoleCapabilityInfo .

Примечания

Важно!

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

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

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

Share via

Find-RoleCapability

Синтаксис

Описание

Примеры

Пример 1. Поиск возможностей роли

Пример 2. Поиск возможностей роли по имени

Пример 3. Поиск и сохранение модуля возможности роли

Пример 4. Поиск и установка модуля возможности роли

Параметры

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Входные данные

Выходные данные

Примечания

Обратная связь

Дополнительные ресурсы

Share via

Find-RoleCapability

Синтаксис

Описание

Примеры

Пример 1. Поиск возможностей роли

Пример 2. Поиск возможностей роли по имени

Пример 3. Поиск и сохранение модуля возможности роли

Пример 4. Поиск и установка модуля возможности роли

Параметры

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Входные данные

Выходные данные

Примечания

Связанные ссылки

Обратная связь

Дополнительные ресурсы