acerca de la configuración de la política de grupo

Breve descripción

Describe la configuración de la política de grupo para PowerShell.

Descripción larga

PowerShell incluye configuraciones de directiva de grupo para ayudarlo a definir valores de configuración consistentes para computadoras con Windows en un entorno empresarial.

La configuración de la política de grupo de PowerShell se encuentra en las siguientes rutas de política de grupo:

Computer Configuration\
  Administrative Templates\
    PowerShell Core

User Configuration\
  Administrative Templates\
    PowerShell Core

La configuración de la política de grupo en la ruta de Configuración del equipo tiene prioridad sobre la configuración de la Política de grupo en la ruta de Configuración del usuario.

PowerShell 7 incluye plantillas de directiva de grupo y un script de instalación en $PSHOME.

Las herramientas de políticas de grupo utilizan archivos de plantilla administrativa (.admx, .adml) para completar la configuración de políticas en la interfaz de usuario. Esto permite a los administradores administrar la configuración de políticas basadas en el registro. El script InstallPSCorePolicyDefinitions.ps1 instala plantillas administrativas principales de PowerShell en la máquina local.

Get-ChildItem -Path $PSHOME -Filter *Core*Policy*

    Directory: C:\Program Files\PowerShell\7

Mode       LastWriteTime         Length Name
----       -------------         ------ ----
-a---      2/27/2020 12:38 AM     15861 InstallPSCorePolicyDefinitions.ps1
-a---      2/27/2020 12:28 AM      9675 PowerShellCoreExecutionPolicy.adml
-a---      2/27/2020 12:28 AM      6201 PowerShellCoreExecutionPolicy.admx

Después de instalar las plantillas, puede editar estas configuraciones en el editor de políticas de grupo (gpedit.msc).

Las políticas son las siguientes:

• Configuración de sesión de consola: establece un punto final de configuración en el que se ejecuta PowerShell.
• Activar registro de módulo: establece la propiedad LogPipelineExecutionDetails de los módulos.
• Activar el registro de bloques de scripts de PowerShell: habilita el registro detallado de todos los scripts de PowerShell.
• Activar ejecución de script: establece la política de ejecución de PowerShell.
• Activar transcripción de PowerShell: permite capturar la entrada y salida de comandos de PowerShell en transcripciones basadas en texto.
• Establezca la ruta de origen predeterminada para Update-Help: establece el origen de la Ayuda actualizable en un directorio, no en Internet.

Cada configuración de política de grupo de PowerShell tiene el campo "Usar configuración de política de Windows PowerShell". Esta opción permite utilizar el valor de una configuración de política de grupo de Windows PowerShell similar que se encuentra en las siguientes rutas de política de grupo:

Computer Configuration\
  Administrative Templates\
    Windows Components\
      Windows PowerShell

User Configuration\
  Administrative Templates\
    Windows Components\
      Windows PowerShell

Configuración de sesión de consola

La configuración de política Configuración de sesión de consola especifica un punto final de configuración en el que se ejecuta PowerShell. Puede ser cualquier punto final registrado en la máquina local, incluidos los puntos finales remotos predeterminados de PowerShell o un punto final personalizado que tenga capacidades de rol de usuario específicas.

Activar el registro del módulo

La configuración de política Activar registro de módulo activa el registro para módulos de PowerShell seleccionados. La configuración es efectiva en todas las sesiones en todas las computadoras afectadas.

Si habilita esta configuración de directiva y especifica uno o más módulos, PowerShell registra los eventos de ejecución de canalización para los módulos especificados en el registro de Windows PowerShell en el Visor de eventos.

Si deshabilita esta configuración de política, PowerShell no registra eventos de ejecución para ningún módulo de PowerShell.

Si esta configuración de política no está configurada, la propiedad LogPipelineExecutionDetails de cada módulo determina si PowerShell registra los eventos de ejecución de ese módulo. De forma predeterminada, la propiedad LogPipelineExecutionDetails de todos los módulos está establecida en $False.

Para activar el registro de módulo para un módulo, utilice el siguiente formato de comando. El módulo debe importarse a la sesión y la configuración solo es efectiva en la sesión actual.

Import-Module <Module-Name>
(Get-Module <Module-Name>).LogPipelineExecutionDetails = $true

Para activar el registro del módulo para todas las sesiones en una computadora en particular, agregue los comandos anteriores al perfil de PowerShell 'Todos los usuarios' ($Profile.AllUsersAllHosts).

Para obtener más información sobre el registro de módulos, consulte about_Modules.

Activar el registro de bloques de scripts de PowerShell

La configuración de política Activar el registro de bloques de secuencias de comandos de PowerShell permite el registro de todas las entradas de secuencias de comandos de PowerShell en el registro de eventos operativos/de Microsoft-Windows-PowerShell. Si habilita esta configuración de política, PowerShell registra el procesamiento de comandos, bloques de secuencias de comandos, funciones y secuencias de comandos, ya sea que se invoquen de forma interactiva o mediante automatización.

Si deshabilita esta configuración de directiva, la entrada del script de PowerShell no se registra. Si habilita el registro de invocación de bloque de script, PowerShell también registra eventos cuando se inicia o se detiene la invocación de un comando, bloque de script, función o script. Habilitar el registro de invocación genera un gran volumen de registros de eventos.

Activar la ejecución del script

La configuración de política Activar ejecución de secuencias de comandos establece la política de ejecución para computadoras y usuarios. La política de ejecución determina si se permite la ejecución de scripts.

Si habilita la configuración de política, puede seleccionar entre las siguientes configuraciones de política.

• Permitir solo secuencias de comandos firmadas permite que las secuencias de comandos se ejecuten solo si están firmadas por un editor confiable. Esta configuración de política es equivalente a la política de ejecución AllSigned.

• Permitir secuencias de comandos locales y secuencias de comandos firmadas remotamente permite que se ejecuten todas las secuencias de comandos locales. Los scripts que se originan en Internet deben estar firmados por un editor confiable. Esta configuración de política es equivalente a la política de ejecución RemoteSigned.

• Permitir todos los scripts permite que se ejecuten todos los scripts. Esta configuración de política es equivalente a la política de ejecución Sin restricciones.

Si deshabilita esta configuración de política, no se permitirá la ejecución de ningún script. Esta configuración de política es equivalente a la política de ejecución Restringida.

Si no configura esta configuración de directiva, la política de ejecución establecida para el equipo o usuario mediante el cmdlet Set-ExecutionPolicy determina si se permite la ejecución de scripts. El valor predeterminado es Restringido.

Para obtener más información, consulte about_Execution_Policies.

Activar la transcripción de PowerShell

La configuración de política Activar transcripción de PowerShell le permite capturar la entrada y salida de los comandos de PowerShell en transcripciones basadas en texto. Si habilita esta configuración de directiva, PowerShell habilita el registro de transcripción para PowerShell y cualquier otra aplicación que aproveche el motor de PowerShell. De forma predeterminada, PowerShell registra la salida de la transcripción en el directorio Mis documentos de cada usuario, con un nombre de archivo que incluye PowerShell_transcript, junto con el nombre de la computadora y la hora de inicio. Habilitar esta política tiene el mismo efecto que llamar al cmdlet Start-Transcript en cada sesión de PowerShell.

Si deshabilita esta configuración de directiva, las aplicaciones basadas en PowerShell no escriben registros de transcripción de forma predeterminada. El cmdlet Start-Transcript aún puede habilitar el registro de transcripción.

Limite el acceso al directorio al configurar OutputDirectory en una ubicación compartida para el registro de transcripciones para evitar que los usuarios vean las transcripciones de otros usuarios o computadoras.

Establecer la ruta de origen predeterminada para Actualización-Ayuda

La configuración de directiva Establecer la ruta de origen predeterminada para Update-Help establece un valor predeterminado para el parámetro SourcePath del cmdlet Update-Help. Esta configuración impide que los usuarios utilicen el cmdlet Update-Help para descargar archivos de ayuda de Internet.

El cmdlet Update-Help descarga e instala los archivos de ayuda más recientes para los módulos de PowerShell y los instala en la computadora. De forma predeterminada, Update-Help descarga nuevos archivos de ayuda desde una ubicación de Internet especificada por el módulo.

Sin embargo, puede usar el cmdlet Save-Help para descargar los archivos de ayuda más recientes a una ubicación del sistema de archivos, como un recurso compartido de red, y luego usar el cmdlet Update-Help. para obtener los archivos de ayuda de la ubicación del sistema de archivos e instalarlos en la computadora. El parámetro SourcePath del cmdlet Update-Help especifica la ubicación del sistema de archivos.

Al proporcionar un valor predeterminado para el parámetro SourcePath, esta configuración de política de grupo agrega implícitamente el parámetro SourcePath a todos los comandos Update-Help. Los usuarios pueden anular la ubicación particular del sistema de archivos especificada como valor predeterminado ingresando una ubicación del sistema de archivos diferente. Pero no pueden eliminar el parámetro SourcePath del comando Update-Help.

Si habilita esta configuración de política, puede especificar un valor predeterminado para el parámetro SourcePath. Ingrese una ubicación del sistema de archivos.

Si esta configuración de directiva está deshabilitada o no está configurada, no hay ningún valor predeterminado para el parámetro SourcePath del cmdlet Update-Help. Los usuarios pueden descargar ayuda de Internet o desde cualquier ubicación del sistema de archivos.

Para obtener más información, consulte about_Updatable_Help.

Palabras clave

about_Group_Policies acerca de_GroupPolicy

Ver también

• about_Execution_Policies
• acerca de_Módulos
• about_Updatable_Ayuda
• Get-ExecutionPolicy
• Set-ExecutionPolicy
• Update-Help
• Save-Help
• Get-Module