Ottiene i criteri di esecuzione per la sessione corrente.

Sintassi

Get-ExecutionPolicy [[-Scope] {<Process> | <CurrentUser> | <LocalMachine> | <UserPolicy> | <MachinePolicy>}] [-List] [<CommonParameters>]

Descrizione

Il cmdlet Get-ExecutionPolicy ottiene i criteri di esecuzione per la sessione corrente.

Tale criterio è determinato dai criteri di esecuzione specificati dall'utente utilizzando Set-ExecutionPolicy e dalle impostazioni dei Criteri di gruppo per il criterio di esecuzione di Windows PowerShell. Il valore predefinito è "Restricted".

Senza parametri, Get-ExecutionPolicy ottiene i criteri di esecuzione effettivi nella sessione. È possibile utilizzare il parametro List per ottenere tutti i criteri di esecuzione che influiscono sulla sessione o il parametro Scope per ottenere i criteri di esecuzione per un particolare ambito.

Per ulteriori informazioni, vedere about_Execution_Policies.

Parametri

-List

Ottiene tutti i valori dei criteri di esecuzione per la sessione elencata in ordine di precedenza. Per impostazione predefinita, Get-ExecutionPolicy ottiene unicamente i criteri di esecuzione effettivi.

Obbligatorio?

false

Posizione?

named

Valore predefinito

False

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Scope <ExecutionPolicyScope>

Ottiene i criteri di esecuzione nell'ambito specificato. Per impostazione predefinita, Get-ExecutionPolicy ottiene i criteri di esecuzione effettivi per la sessione corrente.

I valori validi sono:

-- MachinePolicy: i criteri di esecuzione impostati da Criteri di gruppo per tutti gli utenti del computer.

-- UserPolicy: i criteri di esecuzione impostati da Criteri di gruppo per l'utente corrente del computer.

-- Process: i criteri di esecuzione impostati per il processo corrente di Windows PowerShell.

-- CurrentUser: i criteri di esecuzione impostati per l'utente corrente.

-- LocalMachine: i criteri di esecuzione impostati per tutti gli utenti del computer.

Obbligatorio?

false

Posizione?

1

Valore predefinito

Effective execution policy

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

Nessuno

Non è possibile reindirizzare l'input a questo cmdlet.

Output

Microsoft.PowerShell.ExecutionPolicy

Get-ExecutionPolicy restituisce un oggetto per ogni criterio di esecuzione ottenuto.

Note

Non è possibile utilizzare Get-ExecutionPolicy per ottenere particolari criteri di esecuzione impostati per un determinato ambito o per ottenere il criterio di esecuzione impostato da un Criterio di gruppo. Get-ExecutionPolicy ottiene solo i criteri di esecuzione validi determinati dall'applicazione di tutte le regole di precedenza.

Il criterio di esecuzione fa parte della strategia di sicurezza di Windows PowerShell. Esso determina se è possibile caricare file di configurazione, incluso il profilo di Windows PowerShell, ed eseguire script, nonché determina quali script, se presenti, devono essere firmati digitalmente per poter essere eseguiti.

Il criterio di esecuzione in uso è determinato dai criteri impostati dall'utente utilizzando Set-ExecutionPolicy e dai Criteri di gruppo relativi all'attivazione dell'esecuzione degli script per computer e utenti. L'ordine di precedenza è criteri di gruppo computer > criteri di gruppo utente > criteri di esecuzione processo (sessione) > criteri di esecuzione utente > criteri di esecuzione computer.

Per ulteriori informazioni sui criteri di esecuzione di Windows PowerShell, incluse le definizioni dei criteri di Windows PowerShell, vedere about_Execution_Policies.

Esempio 1

C:\PS>get-executionpolicy

Restricted

Descrizione
-----------
Tramite questo comando viene ottenuto il criterio di esecuzione corrente per la shell.






Esempio 2

C:\PS>set-executionpolicy RemoteSigned; get-executionPolicy

RemoteSigned

Descrizione
-----------
Tramite questi comandi vengono definite nuove impostazioni per il criterio di esecuzione della shell e viene visualizzato il criterio di esecuzione in uso. I comandi sono separati da un punto e virgola (;). Poiché non vi sono impostazioni dei Criteri di gruppo, in questo esempio l'impostazione definita dall'utente corrisponde al criterio in uso nella shell.






Esempio 3

C:\PS>get-executionpolicy -list

        Scope  ExecutionPolicy
        -----  ---------------
MachinePolicy  Undefined
   UserPolicy  Undefined
      Process  Undefined
  CurrentUser  AllSigned
 LocalMachine  RemoteSigned

C:\PS> get-executionpolicy
AllSigned

Descrizione
-----------
Questi comandi ottengono tutti i criteri di esecuzione nella sessione corrente e i criteri di esecuzione effettivi.

Con il primo comando si ottengono tutti i criteri di esecuzione che influiscono sulla sessione corrente. I criteri sono elencati in ordine di precedenza.

Con il secondo comando si ottengono unicamente i criteri di esecuzione effettivi, ovvero quelli impostati nell'ambito CurrentUser.






Vedere anche




Argomenti della Guida