共用方式為

Get-PSSessionCapability

  • 參考
模組:
Microsoft.PowerShell.Core

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

Syntax

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

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

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