Get-PSSessionCapability

參考

模組:: Microsoft.PowerShell.Core

取得特定使用者對於限制工作階段設定的能力。

Syntax

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

Description

Cmdlet Get-PSSessionCapability 會取得限制會話組態上特定使用者的功能。若要稽核使用者的自訂工作階段設定，請使用此 Cmdlet。

從 Windows PowerShell 5.0 開始，您可以在會話組態 () .pssc 檔案中使用 RoleDefinitions 屬性。使用這個屬性可讓您根據群組成員資格，授與使用者對於單一限制端點不同的能力。 Cmdlet Get-PSSessionCapability 可讓您判斷授與用戶的確切功能，藉以在稽核這些端點時減少複雜性。

根據預設， Get-PSSessionCapability Cmdlet 會傳回指定使用者可在指定端點中執行的命令清單。這相當於在指定端點中執行 Get-Command 的使用者。搭配 Full 參數執行時，此 Cmdlet 會傳回 InitialSessionState 物件。此物件包含指定使用者針對指定端點互動之 PowerShell Runspace 的詳細數據。它包含語言模式、執行原則和環境變數等資訊。

範例

範例 1︰取得使用者可用的命令

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'

本範例會在連線到本機計算機上的 Endpoint1 限制端點時，傳回使用者 CONTOSO\User 可用的命令。

範例 2︰取得使用者的 Runspace 相關詳細資料

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full

本範例會傳回使用者 CONTOSO\User 連線至 Endpoint1 限制端點時，會與其互動之 Runspace 的詳細數據。

參數

-ConfigurationName

指定您要檢查的限制工作階段設定 (端點)。

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

-Full

指出此 Cmdlet 會傳回指定使用者在指定限制端點的整個初始工作階段狀態。

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

New-PSRoleCapabilityFile