Find-RoleCapability
モジュールのロール機能を検索します。
構文
All
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
結果にプレリリースとしてマークされたリソースが含まれます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AllVersions
このコマンドレットがモジュールのすべてのバージョンを取得することを示します。 AllVersions パラメーターには、モジュールの使用可能な各バージョンが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Filter
PackageManagement プロバイダーの検索構文に基づいてリソースを検索します。 たとえば、ModuleName 内で検索する単語と Description プロパティを指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaximumVersion
結果に含めるモジュールの最大バージョンを指定します。 MaximumVersion パラメーターと RequiredVersion パラメーターを同じコマンドで使用することはできません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MinimumVersion
結果に含めるモジュールの最小バージョンを指定します。 MinimumVersion と RequiredVersion パラメーターは、同じコマンドでは使用できません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModuleName
ロール機能を検索するモジュールの名前を指定します。 既定値は、すべてのモジュールです。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
ロール機能の名前を指定します。 既定値は、すべてのロール機能です。 リソース名の配列を区切るには、コンマを使用します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Proxy
インターネット リソースへの直接接続ではなく、要求のプロキシ サーバーを指定します。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ProxyCredential
Proxy パラメーターで指定されたプロキシ サーバーを使用するアクセス許可を持つユーザー アカウントを指定します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Repository
ロール機能を検索するリポジトリを指定します。 リポジトリ名の配列を区切るには、コンマを使用します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RequiredVersion
結果に含めるモジュールの正確なバージョン番号を指定します。 RequiredVersion パラメーターと MinimumVersion パラメーターは、同じコマンドでは使用できません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Tag
リポジトリ内のモジュールを分類するタグを指定します。 タグの配列を区切るには、コンマを使用します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
Uri
PSCredential
出力
PSGetRoleCapabilityInfo
Find-RoleCapability コマンドレットは PSGetRoleCapabilityInfo オブジェクトを返します。
メモ
Von Bedeutung
2020 年 4 月の時点で、PowerShell ギャラリーはトランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 をサポートしなくなりました。 TLS 1.2 以降を使用していない場合は、PowerShell ギャラリーにアクセスしようとするとエラーが表示されます。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
詳細については、PowerShell ブログの のお知らせ を参照してください。
