Get-PSSessionCapability
取得特定使用者在限制會話組態中的能力。
語法
Default (預設值)
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Description
Get-PSSessionCapability Cmdlet 會取得限制會話設定中特定使用者的權限。 使用此 Cmdlet 來稽核使用者的自訂會話設定。
從 Windows PowerShell 5.0 開始，您可以在會話組態 （） 檔案中使用 .pssc 属性。 使用此屬性可讓您根據群組成員資格，將單一限制端點上的不同功能授與使用者。
Get-PSSessionCapability Cmdlet 可讓您判斷授與給用戶的確切功能，藉此減少稽核這些端點時的複雜性。
根據預設，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 時會與之互動的執行空間詳細資訊。
參數
-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。
