Get-PSSessionCapability

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Ottiene le funzionalità di un utente specifico in una configurazione di sessione vincolata.

Sintassi

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

Descrizione

Il Get-PSSessionCapability cmdlet ottiene le funzionalità di un utente specifico in una configurazione di sessione vincolata. Usare questo cmdlet per controllare le configurazioni di sessione personalizzate per gli utenti.

A partire da Windows PowerShell 5.0, è possibile usare la proprietà RoleDefinitions in un file di configurazione sessione (.pssc). L'uso di questa proprietà consente di concedere agli utenti funzionalità diverse in un singolo endpoint vincolato in base all'appartenenza al gruppo. Il Get-PSSessionCapability cmdlet riduce la complessità durante il controllo di questi endpoint consentendo di determinare le funzionalità esatte concesse a un utente.

Per impostazione predefinita, il Get-PSSessionCapability cmdlet restituisce un elenco di comandi che l'utente specificato può eseguire nell'endpoint specificato. Equivale all'utente in esecuzione Get-Command nell'endpoint specificato. Quando viene eseguito con il parametro Full , questo cmdlet restituisce un oggetto InitialSessionState . Questo oggetto contiene informazioni dettagliate sullo spazio di esecuzione di PowerShell con cui l'utente specificato interagirà per l'endpoint specificato. Include informazioni quali la modalità del linguaggio, i criteri di esecuzione e le variabili ambientali.

Esempio

Esempio 1: Ottenere i comandi disponibili per un utente

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'

In questo esempio vengono restituiti i comandi disponibili per l'utente CONTOSO\User durante la connessione all'endpoint vincolato Endpoint1 nel computer locale.

Esempio 2: Ottenere dettagli su uno spazio di esecuzione per un utente

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full

In questo esempio vengono restituiti dettagli sullo spazio di esecuzione con cui l'utente CONTOSO\User interagisce durante la connessione all'endpoint vincolato Endpoint1.

Parametri

-ConfigurationName

Specifica la configurazione della sessione vincolata (endpoint) che si sta esaminando.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Full

Indica che questo cmdlet restituisce l'intero stato iniziale della sessione per l'utente specificato nell'endpoint vincolato specificato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Username

Specifica l'utente le cui funzionalità vengono esaminate.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Output

AliasInfo

FunctionInfo

InitialSessionState