Get-PSSessionCapability
Ottiene le funzionalità di un utente specifico in una configurazione di sessione vincolata.
Sintassi
Default (Impostazione predefinita)
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 Windows 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Full
Indica che questo cmdlet restituisce l'intero stato iniziale della sessione per l'utente specificato nell'endpoint vincolato specificato.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Username
Specifica l'utente le cui funzionalità vengono esaminate.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
