Get-PSSessionCapability

  • リファレンス
モジュール:
Microsoft.PowerShell.Core

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

構文

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 オブジェクトを返します。 このオブジェクトには、指定したユーザーが指定したエンドポイントで操作する Windows 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

検査する制約付きセッション構成 (エンドポイント) を指定します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Full

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Username

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

出力

AliasInfo

FunctionInfo

InitialSessionState