次の方法で共有

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: ユーザーが使用できるコマンドを取得する

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\EvanNa"

次の使用例は、ローカル コンピューター上の Endpoint1 制約付きエンドポイントに接続するときに、ユーザー CONTOSO\EvanNa が使用できるコマンドを返します。

例 2: ユーザーの実行空間に関する詳細を取得する

PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\PattiFul" -Full

このコマンドは、ユーザー CONTOSO\PattiFul が Endpoint1 の制約付きエンドポイントに接続するときに操作する実行空間に関する詳細を返します。

パラメーター

-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