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