Condividi tramite

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 cmdlet Get-PSSessionCapability 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 di 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 cmdlet Get-PSSessionCapability riduce la complessità durante il controllo di questi endpoint consentendo di determinare le funzionalità esatte concesse a un utente.

Per impostazione predefinita, il cmdlet Get-PSSessionCapability restituisce un elenco di comandi che l'utente specificato può eseguire nell'endpoint specificato. Equivale all'utente che esegue 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 interagirà durante la connessione all'endpoint vincolato Endpoint1.

Parametri

-ConfigurationName

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

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Full

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Username

Specifica l'utente le cui funzionalità vengono esaminate.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

AliasInfo

FunctionInfo

InitialSessionState