Set-ExecutionPolicy
Imposta i criteri di esecuzione di PowerShell per i computer Windows.
Sintassi
Set-ExecutionPolicy
[-ExecutionPolicy] <ExecutionPolicy>
[[-Scope] <ExecutionPolicyScope>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il Set-ExecutionPolicy
cmdlet modifica i criteri di esecuzione di PowerShell per i computer Windows. Per altre informazioni, vedere about_Execution_Policies.
Un criterio di esecuzione fa parte della strategia di sicurezza di PowerShell. I criteri di esecuzione determinano se è possibile caricare i file di configurazione, ad esempio il profilo di PowerShell o eseguire script. Inoltre, se gli script devono essere firmati digitalmente prima di essere eseguiti.
L'ambito Set-ExecutionPolicy
predefinito del cmdlet è LocalMachine, che interessa tutti gli utenti che usano il computer. Per modificare i criteri di esecuzione per LocalMachine, avviare PowerShell con Run as Administrator.
Per visualizzare i criteri di esecuzione per ogni ambito nell'ordine di precedenza, usare Get-ExecutionPolicy -List
. Per visualizzare i criteri di esecuzione effettivi per la sessione di PowerShell, usare Get-ExecutionPolicy
senza parametri.
Esempio
Esempio 1: Impostare un criterio di esecuzione
In questo esempio viene illustrato come impostare i criteri di esecuzione per il computer locale.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
Get-ExecutionPolicy -List
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser RemoteSigned
LocalMachine RemoteSigned
Il Set-ExecutionPolicy
cmdlet usa il parametro ExecutionPolicy per specificare il criterio RemoteSigned . Il parametro Scope specifica il valore di ambito predefinito LocalMachine. Per visualizzare le impostazioni dei criteri di esecuzione, usare il cmdlet con il Get-ExecutionPolicy
parametro List .
Esempio 2: Impostare un criterio di esecuzione in conflitto con un Criteri di gruppo
Questo comando tenta di impostare i criteri di esecuzione dell'ambito LocalMachine su Restricted. LocalMachine è più restrittivo, ma non è il criterio efficace perché è in conflitto con un Criteri di gruppo. I criteri con restrizioni sono scritti nell'hive del Registro di sistema HKEY_LOCAL_MACHINE.
PS> Set-ExecutionPolicy -ExecutionPolicy Restricted -Scope LocalMachine
Set-ExecutionPolicy : PowerShell updated your local preference successfully, but the setting is
overridden by the Group Policy applied to your system. Due to the override, your shell will retain
its current effective execution policy of "AllSigned". Contact your Group Policy administrator for
more information. At line:1 char:20 + Set-ExecutionPolicy <<<< restricted
PS> Get-ChildItem -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds
Hive: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PowerShell\1\ShellIds
Name Property
---- --------
Microsoft.PowerShell Path : C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : Restricted
ScriptedDiagnostics ExecutionPolicy : Unrestricted
Il Set-ExecutionPolicy
cmdlet usa il parametro ExecutionPolicy per specificare i criteri con restrizioni . Il parametro Scope specifica il valore di ambito predefinito LocalMachine.
Il Get-ChildItem
cmdlet usa il parametro Path con il provider HKLM per specificare il percorso del Registro di sistema.
Esempio 3: Applicare i criteri di esecuzione da un computer remoto a un computer locale
Questo comando ottiene l'oggetto criteri di esecuzione da un computer remoto e imposta i criteri nel computer locale. Get-ExecutionPolicy
invia un oggetto Microsoft.PowerShell.ExecutionPolicy nella pipeline. Set-ExecutionPolicy
accetta l'input della pipeline e non richiede il parametro ExecutionPolicy .
PS> Invoke-Command -ComputerName Server01 -ScriptBlock { Get-ExecutionPolicy } | Set-ExecutionPolicy
Il Invoke-Command
cmdlet viene eseguito nel computer locale e invia ScriptBlock al computer remoto. Il parametro ComputerName specifica il computer remoto Server01. Il parametro ScriptBlock viene eseguito Get-ExecutionPolicy
nel computer remoto. L'oggetto Get-ExecutionPolicy
viene inviato alla pipeline all'oggetto Set-ExecutionPolicy
.
Set-ExecutionPolicy
applica i criteri di esecuzione all'ambito predefinito del computer locale , LocalMachine.
Esempio 4: Impostare l'ambito per un criterio di esecuzione
In questo esempio viene illustrato come impostare un criterio di esecuzione per un ambito specificato, CurrentUser. L'ambito CurrentUser influisce solo sull'utente che imposta questo ambito.
Set-ExecutionPolicy -ExecutionPolicy AllSigned -Scope CurrentUser
Get-ExecutionPolicy -List
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine RemoteSigned
Set-ExecutionPolicy
usa il parametro ExecutionPolicy per specificare il criterio AllSigned .
Il parametro Scope specifica CurrentUser. Per visualizzare le impostazioni dei criteri di esecuzione, usare il cmdlet con il Get-ExecutionPolicy
parametro List .
I criteri di esecuzione effettivi per l'utente diventa AllSigned.
Esempio 5: Rimuovere i criteri di esecuzione per l'utente corrente
In questo esempio viene illustrato come usare i criteri di esecuzione non definiti per rimuovere un criterio di esecuzione per un ambito specificato.
Set-ExecutionPolicy -ExecutionPolicy Undefined -Scope CurrentUser
Get-ExecutionPolicy -List
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser Undefined
LocalMachine RemoteSigned
Set-ExecutionPolicy
usa il parametro ExecutionPolicy per specificare i criteri non definiti .
Il parametro Scope specifica CurrentUser. Per visualizzare le impostazioni dei criteri di esecuzione, usare il cmdlet con il Get-ExecutionPolicy
parametro List .
Esempio 6: Impostare i criteri di esecuzione per la sessione di PowerShell corrente
L'ambito Processo influisce solo sulla sessione di PowerShell corrente. I criteri di esecuzione vengono salvati nella variabile $env:PSExecutionPolicyPreference
di ambiente ed vengono eliminati quando la sessione viene chiusa.
Set-ExecutionPolicy -ExecutionPolicy AllSigned -Scope Process
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process AllSigned
CurrentUser RemoteSigned
LocalMachine RemoteSigned
Usa Set-ExecutionPolicy
il parametro ExecutionPolicy per specificare il criterio AllSigned . Il parametro Scope specifica il valore Process. Per visualizzare le impostazioni dei criteri di esecuzione, usare il cmdlet con il Get-ExecutionPolicy
parametro List .
Esempio 7: Sbloccare uno script da eseguire senza modificare i criteri di esecuzione
In questo esempio viene illustrato come il criterio di esecuzione RemoteSigned impedisce l'esecuzione di script senza segno.
È consigliabile leggere il codice dello script e verificare che sia sicuro prima di usare il Unblock-File
cmdlet. Il Unblock-File
cmdlet sblocca gli script in modo che possano essere eseguiti, ma non modifica i criteri di esecuzione.
PS> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
PS> Get-ExecutionPolicy
RemoteSigned
PS> .\Start-ActivityTracker.ps1
.\Start-ActivityTracker.ps1 : File .\Start-ActivityTracker.ps1 cannot be loaded.
The file .\Start-ActivityTracker.ps1 is not digitally signed.
The script will not execute on the system.
For more information, see about_Execution_Policies at https://go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ .\Start-ActivityTracker.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : NotSpecified: (:) [], PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess
PS> Unblock-File -Path .\Start-ActivityTracker.ps1
PS> Get-ExecutionPolicy
RemoteSigned
PS> .\Start-ActivityTracker.ps1
Task 1:
Usa Set-ExecutionPolicy
il parametro ExecutionPolicy per specificare il criterio RemoteSigned . Il criterio è impostato per l'ambito predefinito LocalMachine.
Il Get-ExecutionPolicy
cmdlet mostra che RemoteSigned è il criterio di esecuzione effettivo per la sessione di PowerShell corrente.
Lo script Start-ActivityTracker.ps1 viene eseguito dalla directory corrente. Lo script viene bloccato da RemoteSigned perché lo script non è firmato digitalmente.
Per questo esempio, il codice dello script è stato esaminato e verificato come sicuro da eseguire. Il Unblock-File
cmdlet usa il parametro Path per sbloccare lo script.
Per verificare che Unblock-File
i criteri di esecuzione non siano stati modificati, visualizza i criteri di esecuzione effettivi, Get-ExecutionPolicy
RemoteSigned.
Lo script ,Start-ActivityTracker.ps1 viene eseguito dalla directory corrente. Lo script inizia a essere eseguito perché è stato sbloccato dal Unblock-File
cmdlet.
Parametri
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExecutionPolicy
Specifica i criteri di esecuzione. Se non sono presenti criteri di gruppo e i criteri di esecuzione di ogni ambito sono impostati su Undefined, Restricted diventa il criterio effettivo per tutti gli utenti.
I valori dei criteri di esecuzione accettabili sono i seguenti:
- AllSigned. Richiede che tutti gli script e i file di configurazione siano firmati da un editore attendibile, inclusi gli script scritti nel computer locale.
- Bypass. non viene bloccato niente e non vengono visualizzati avvvisi né prompt.
- Default. Imposta i criteri di esecuzione predefiniti. Limitato per i client Windows o RemoteSigned per i server Windows.
- RemoteSigned. Richiede che tutti gli script e i file di configurazione scaricati da Internet siano firmati da un editore attendibile. Criterio di esecuzione predefinito per i computer windows server.
- Restricted. Non carica i file di configurazione o esegue script. I computer client Windows dei criteri di esecuzione predefiniti.
- Undefined. Nessun criterio di esecuzione è impostato per l'ambito. Rimuove un criterio di esecuzione assegnato da un ambito che non è impostato da un Criteri di gruppo. Se i criteri di esecuzione in tutti gli ambiti non sono definiti, i criteri di esecuzione effettivi sono limitati.
- Unrestricted. carica tutti i file di configurazione ed esegue tutti gli script. Se si esegue uno script non firmato che è stato scaricato da Internet, verrà richiesta l'autorizzazione prima dell'esecuzione.
Type: | ExecutionPolicy |
Accepted values: | AllSigned, Bypass, Default, RemoteSigned, Restricted, Undefined, Unrestricted |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Elimina tutte le richieste di conferma. Prestare attenzione a questo parametro per evitare risultati imprevisti.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Specifica l'ambito interessato da un criterio di esecuzione. L'ambito predefinito è LocalMachine.
I criteri di esecuzione effettivi sono determinati dall'ordine di precedenza come indicato di seguito:
- MachinePolicy. Impostato da un Criteri di gruppo per tutti gli utenti del computer.
- UserPolicy. Impostato da un Criteri di gruppo per l'utente corrente del computer.
- Processo. Influisce solo sulla sessione di PowerShell corrente.
- CurrentUser. Influisce solo sull'utente corrente.
- LocalMachine. Ambito predefinito che influisce su tutti gli utenti del computer.
L'ambito Processo influisce solo sulla sessione di PowerShell corrente. I criteri di esecuzione vengono salvati nella variabile $env:PSExecutionPolicyPreference
di ambiente anziché nel Registro di sistema. Quando la sessione di PowerShell viene chiusa, la variabile e il valore vengono eliminati.
I criteri di esecuzione per l'ambito CurrentUser vengono scritti nell'hive del Registro di sistema HKEY_LOCAL_USER.
I criteri di esecuzione per l'ambito LocalMachine vengono scritti nell'hive del Registro di sistema HKEY_LOCAL_MACHINE.
Type: | ExecutionPolicyScope |
Accepted values: | CurrentUser, LocalMachine, MachinePolicy, Process, UserPolicy |
Position: | 1 |
Default value: | LocalMachine |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.PowerShell.ExecutionPolicy, System.String
È possibile inviare una pipe a un oggetto criteri di esecuzione o una stringa contenente il nome di un criterio di esecuzione in Set-ExecutionPolicy
.
Output
None
Set-ExecutionPolicy
non restituisce alcun output.
Note
Set-ExecutionPolicy
non modifica gli ambiti MachinePolicy e UserPolicy perché vengono impostati da Criteri di gruppo.
Set-ExecutionPolicy
non esegue l'override di un Criteri di gruppo, anche se la preferenza utente è più restrittiva del criterio.
Se la Criteri di gruppo Attiva esecuzione script è abilitata per il computer o l'utente, la preferenza utente viene salvata, ma non è efficace. PowerShell visualizza un messaggio che spiega il conflitto.