Get-PSSessionCapability
在受限的會話配置中取得特定使用者的能力。
語法
Default (預設值)
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Description
指令 Get-PSSessionCapability 長在受限的會話設定中取得特定使用者的能力。 使用此 cmdlet 來審核使用者自訂的會話設定。
從 PowerShell 5.0 開始Windows，你可以在會話設定（.pssc）檔案中使用 RoleDefinitions 屬性。 利用此特性，你可以根據群組成員資格，在單一受限端點上賦予使用者不同的功能。
Get-PSSessionCapability這個指令小程式在審核這些端點時，降低了複雜度，讓你能確定使用者被賦予的具體能力。
預設情況下 Get-PSSessionCapability ，指令檔會回傳指定使用者可在指定端點執行的指令清單。 這等同於使用者在指定端點中運行 Get-Command 。 當執行 Full 參數時，此 cmdlet 會回傳一個 InitialSessionState 物件。 此物件包含指定使用者在指定端點下會互動的 PowerShell 執行空間細節。 它包含語言模式、執行政策及環境變數等資訊。
範例
範例 1：為使用者取得可用的指令
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'
此範例回傳使用者 CONTOSO\User 在連接本地電腦 Endpoint1 約束端點時可用的指令。
範例 2：取得使用者的跑道空間詳細資訊
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。
