Obtiene las directivas de ejecución de la sesión actual.
Sintaxis
Get-ExecutionPolicy [[-Scope] {<Process> | <CurrentUser> | <LocalMachine> | <UserPolicy> | <MachinePolicy>}] [-List] [<CommonParameters>]
Descripción
El cmdlet Get-ExecutionPolicy obtiene las directivas de ejecución de la sesión actual.
Esta directiva de ejecución está determinada por las directivas de ejecución que se establezcan mediante el uso de Set-ExecutionPolicy y la configuración de la directiva de grupo para la directiva de ejecución de Windows PowerShell. El valor predeterminado es "Restricted".
Sin no se especifican parámetros, el cmdlet Get-ExecutionPolicy obtiene la directiva de ejecución vigente en la sesión. Puede utilizar el parámetro List para obtener todas las directivas de ejecución que afectan a la sesión, o bien el parámetro Scope a fin de obtener la directiva de ejecución de un ámbito determinado.
Para obtener más información, vea about_Execution_Policies.
Parámetros
-List
Obtiene todos los valores de directivas de ejecución de la sesión, por orden de precedencia. De forma predeterminada, Get-ExecutionPolicy obtiene solamente la directiva de ejecución vigente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
False |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Scope <ExecutionPolicyScope>
Obtiene la directiva de ejecución del ámbito especificado. De forma predeterminada, Get-ExecutionPolicy obtiene la directiva de ejecución vigente en la sesión actual.
Los valores válidos son:
--MachinePolicy: directiva de ejecución establecida por una directiva de grupo para todos los usuarios del equipo.
--UserPolicy: directiva de ejecución establecida por una directiva de grupo para el usuario actual del equipo.
-- Process: directiva de ejecución establecida para el proceso de Windows PowerShell actual.
-- CurrentUser: directiva de ejecución establecida para el usuario actual.
-- LocalMachine: directiva de ejecución establecida para todos los usuarios del equipo.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
Effective execution policy |
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
Ninguno No se pueden canalizar entradas a este cmdlet. |
|
Salidas |
Microsoft.PowerShell.ExecutionPolicy Get-ExecutionPolicy devuelve un objeto por cada directiva de ejecución que obtiene. |
Notas
No se puede utilizar Get-ExecutionPolicy para obtener directivas de ejecución concretas establecidas para un ámbito determinado ni para obtener la directiva de ejecución establecida por una directiva de grupo. Get-ExecutionPolicy sólo obtiene la directiva de ejecución vigente que resulta de aplicar todas las reglas de prioridad.
La directiva de ejecución forma parte de la estrategia de seguridad de Windows PowerShell. Esta directiva determina si puede cargar archivos de configuración (incluido su perfil de Windows PowerShell) y ejecutar scripts, así como los scripts, si los hubiera, que deben estar firmados digitalmente para que se puedan ejecutar.
La directiva de ejecución vigente está determinada por las directivas que se establezcan mediante el uso de Set-ExecutionPolicy y las directivas de grupo "Activar ejecución de scripts" para equipos y usuarios. El orden de prioridad es: Directiva de grupo de equipos > Directiva de grupo de usuarios > Directiva de ejecución de procesos (sesión) > Directiva de ejecución de usuarios > Directiva de ejecución de equipos.
Para obtener más información detallada acerca de la directiva de ejecución de Windows PowerShell, incluidas las definiciones de las directivas de Windows PowerShell, vea about_Execution_Policies.
Ejemplo 1
C:\PS>get-executionpolicy Restricted Descripción ----------- Este comando obtiene la directiva de ejecución actual del shell.
Ejemplo 2
C:\PS>set-executionpolicy RemoteSigned; get-executionPolicy RemoteSigned Descripción ----------- Estos comandos establecen una nueva preferencia del usuario para la directiva de ejecución del shell y después muestran la directiva de ejecución vigente. Los comandos se separan con un punto y coma (;). En este ejemplo, dado que no se ha establecido una configuración de directivas de grupo, la preferencia del usuario es la directiva vigente del shell.
Ejemplo 3
C:\PS>get-executionpolicy -list
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine RemoteSigned
C:\PS> get-executionpolicy
AllSigned
Descripción
-----------
Estos comandos obtienen todas las directivas de ejecución de la sesión actual y de la directiva de ejecución vigente.
El primer comando obtiene todas las directivas de ejecución que afectan a la sesión actual. Las directivas se muestran por orden de precedencia.
El segundo comando obtiene únicamente la directiva de ejecución vigente, que es la establecida en el ámbito CurrentUser.
Vea también