次の方法で共有


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 オブジェクトは、パイプラインから または Save-Module コマンドレットにInstall-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 モジュールの Path を 指定し、 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-InstalledModuleJeaExamples モジュールがインストールされたことを確認します。

パラメーター

-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-RoleCapabilityPSGetRoleCapabilityInfo オブジェクトを 返します。

メモ

重要

2020 年 4 月時点で、PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 および 1.1 がサポートされなくなります。 TLS 1.2 以降を使用していない場合、PowerShell ギャラリーにアクセスしようとするとエラーが発生します。 次のコマンドを使用して、確実に TLS 1.2 を使用するようにします。

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

詳細については、PowerShell ブログのお知らせを参照してください。