Get-PSSessionCapability
制約付きセッション構成に対する特定のユーザーの機能を取得します。
構文
Default (既定)
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
説明
Get-PSSessionCapability コマンドレットは、制約付きセッション構成に対する特定のユーザーの機能を取得します。 このコマンドレットを使用して、ユーザーのカスタマイズされたセッション構成を監査します。
Windows PowerShell 5.0 以降では、セッション構成 () ファイルで .pssc プロパティを使用できます。 このプロパティを使用すると、グループ メンバーシップに基づいて、1 つの制約付きエンドポイントでユーザーにさまざまな機能を付与できます。
Get-PSSessionCapability コマンドレットを使用すると、ユーザーに付与される正確な機能を判断できるため、これらのエンドポイントを監査するときの複雑さが軽減されます。
既定では、Get-PSSessionCapability コマンドレットは、指定したユーザーが指定したエンドポイントで実行できるコマンドの一覧を返します。 これは、指定したエンドポイントで Get-Command を実行しているユーザーと同じです。
Full パラメーターを指定して実行すると、このコマンドレットは InitialSessionState オブジェクトを返します。 このオブジェクトには、指定したユーザーが指定したエンドポイントで操作する PowerShell 実行空間に関する詳細が含まれています。 これには、言語モード、実行ポリシー、環境変数などの情報が含まれます。
例
例 1: ユーザーが使用できるコマンドを取得する
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'
次の使用例は、ローカル コンピューター上の Endpoint1 制約付きエンドポイントに接続するときに CONTOSO\User ユーザーが使用できるコマンドを返します。
例 2: ユーザーの実行空間に関する詳細を取得する
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full
次の使用例は、Endpoint1 制約付きエンドポイントに接続するときにユーザー CONTOSO\User が操作する実行空間の詳細を返します。
パラメーター
-ConfigurationName
検査する制約付きセッション構成 (エンドポイント) を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Full
このコマンドレットは、指定した制約付きエンドポイントで、指定したユーザーの初期セッション状態全体を返します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Username
機能を確認するユーザーを指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
