Find-RoleCapability

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-ModuleSave-Module командлеты.

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

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

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

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

Командлет 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 .

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 установлен.

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

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