Get-PSSessionCapability

取得特定使用者在限制會話組態中的能力。

語法

Default (預設值)

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

Description

Get-PSSessionCapability Cmdlet 會取得限制會話設定上特定使用者的功能。 使用此 Cmdlet 來稽核使用者的自訂會話設定。

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

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

範例

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

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

此範例會傳回本機計算機上連接到 Endpoint1 限制端點時,使用者 CONTOSO\EvanNa 可用的命令。

範例 2:取得使用者 Runspace 的相關詳細數據

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

此命令會傳回使用者 CONTOSO\PattiFul 連線到 Endpoint1 限制端點時會與其互動之 Runspace 的詳細數據。

參數

-ConfigurationName

指定您正在檢查的受限制工作階段配置(端點)。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Full

指出這個 Cmdlet 會傳回指定端點上指定使用者的完整初始工作階段狀態。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Username

指定您要檢查的使用者及其功能。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸出

AliasInfo

FunctionInfo

InitialSessionState