次の方法で共有


Get-PSSessionCapability

制約付きセッション構成に対する特定のユーザーの機能を取得します。

構文

Get-PSSessionCapability
   [-ConfigurationName] <String>
   [-Username] <String>
   [-Full]
   [<CommonParameters>]

説明

Get-PSSessionCapability コマンドレットは、制約付きセッション構成に対する特定のユーザーの機能を取得します。 このコマンドレットを使用して、ユーザーのカスタマイズされたセッション構成を監査します。

Windows PowerShell 5.0 以降では、セッション構成 (.pssc) ファイルで RoleDefinitions プロパティを使用できます。 このプロパティを使用すると、グループ メンバーシップに基づいて、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
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Full

このコマンドレットは、指定した制約付きエンドポイントで、指定したユーザーの初期セッション状態全体を返します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Username

検査する機能を持つユーザーを指定します。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

AliasInfo

FunctionInfo

InitialSessionState