Export-Console
Exporta los nombres de los complementos de la sesión actual a un archivo de consola.
Sintaxis
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
El cmdlet Export-Console exporta los nombres de los complementos de Windows PowerShell de la sesión actual a un archivo de consola de Windows PowerShell (.psc1). Puede usar este cmdlet para guardar los complementos para usarlos en sesiones futuras.
Para agregar los complementos en el archivo de consola .psc1 a una sesión, inicie Windows PowerShell (Powershell.exe) en la línea de comandos mediante Cmd.exe u otra sesión de Windows PowerShell y, a continuación, use el parámetro PSConsoleFile de Powershell.exe para especificar el archivo de consola.
Para obtener más información sobre los complementos de Windows PowerShell, consulte about_PSSnapins.
Ejemplos
Ejemplo 1: Exportación de los nombres de los complementos en la sesión actual
PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1Este comando exporta los nombres de los complementos de Windows PowerShell en la sesión actual al archivo ConsoleS1.psc1 en la carpeta Consolas de la carpeta de instalación de Windows PowerShell, $pshome.
Ejemplo 2: Exportar los nombres de los complementos al archivo de consola más reciente
PS C:\> Export-ConsoleEste comando exporta los nombres de los complementos de Windows PowerShell de la sesión actual al archivo de consola de Windows PowerShell que se usó más recientemente en la sesión actual. Sobrescribe el contenido del archivo anterior.
Si no ha exportado un archivo de consola durante la sesión actual, se le pedirá permiso para continuar y, a continuación, se le pedirá un nombre de archivo.
Ejemplo 3: Agregar un complemento y exportar los nombres de los complementos
PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1Estos comandos agregan el complemento NewPSSnapin de Windows PowerShell a la sesión actual, exportan los nombres de los complementos de Windows PowerShell en la sesión actual a un archivo de consola y, a continuación, inician una sesión de Windows PowerShell con el archivo de consola.
El primer comando usa el cmdlet Add-PSSnapin para agregar el complemento NewPSSnapin a la sesión actual. Solo puede agregar complementos de Windows PowerShell registrados en el sistema.
El segundo comando exporta los nombres de complemento de Windows PowerShell al archivo NewPSSnapinConsole.psc1.
El tercer comando inicia Windows PowerShell con el archivo NewPSSnapinConsole.psc1. Dado que el archivo de consola incluye el nombre del complemento de Windows PowerShell, los cmdlets y proveedores del complemento están disponibles en la sesión actual.
Ejemplo 4: Exportación de nombres de complementos a una ubicación especificada
PS C:\> export-console -path Console01
PS C:\> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
<PSVersion>2.0</PSVersion>
<PSSnapIns>
<PSSnapIn Name="NewPSSnapin" />
</PSSnapIns>
</PSConsoleFile>Este comando exporta los nombres de los complementos de Windows PowerShell en la sesión actual al archivo Console01.psc1 en el directorio actual.
El segundo comando muestra el contenido del archivo Console01.psc1 en el Bloc de notas.
Ejemplo 5: Determinación del archivo de consola que se va a actualizar
PS C:\> powershell.exe -PSConsoleFile Console01.psc1
PS C:\> Add-PSSnapin MySnapin
PS C:\> Export-Console NewConsole.psc1
PS C:\> $ConsoleFileName
PS C:\> Add-PSSnapin SnapIn03
PS C:\> Export-ConsoleEn este ejemplo se muestra cómo usar la variable automática $ConsoleFileName para determinar el archivo de consola que se actualizará si usa
El primer comando usa el parámetro PSConsoleFile de PowerShell.exe para abrir Windows PowerShell con el archivo Console01.psc1.
El segundo comando usa el cmdlet Add-PSSnapin para agregar el complemento MySnapin de Windows PowerShell a la sesión actual.
El tercer comando usa el cmdlet Export-Console para exportar los nombres de todos los complementos de Windows PowerShell de la sesión al archivo NewConsole.psc1.
El cuarto comando muestra la variable $ConsoleFileName. Contiene el archivo de consola usado más recientemente. La salida de ejemplo muestra que NewConsole.ps1 es el archivo usado más recientemente.
El quinto comando agrega SnapIn03 a la consola actual.
El sexto comando usa el cmdlet Export-Console sin un parámetro Path. Este comando exporta los nombres de todos los complementos de Windows PowerShell de la sesión actual al archivo usado más recientemente, NewConsole.psc1.
Parámetros
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Indica que este cmdlet sobrescribe los datos en un archivo de consola sin advertencia, incluso si el archivo tiene el atributo de solo lectura. El atributo de solo lectura se cambia y no se restablece cuando finaliza el comando.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-NoClobber
Indica que este cmdlet no sobrescribe un archivo de consola existente. De forma predeterminada, si se produce un archivo en la ruta de acceso especificada, Export-Console sobrescribe el archivo sin advertencia.
| Tipo: | SwitchParameter |
| Alias: | NoOverwrite |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Path
Especifica una ruta de acceso y un nombre de archivo para el archivo de consola (*.psc1). Escriba una ruta de acceso y un nombre opcionales. No se permiten caracteres comodín.
Si especifica solo un nombre de archivo, Export-Console crea un archivo que tiene ese nombre y la extensión de nombre de archivo .psc1 en el directorio actual.
Este parámetro es necesario a menos que haya abierto Windows PowerShell con el parámetro PSConsoleFile o haya exportado un archivo de consola durante la sesión actual. También es necesario cuando se usa el parámetro NoClobber para evitar que se sobrescriba el archivo de consola actual.
Si omite este parámetro, Export-Console sobrescribe el archivo de consola que se usó más recientemente en esta sesión. La ruta de acceso del archivo de consola usado más recientemente se almacena en el valor del $ConsoleFileName variable automática. Para obtener más información, consulte about_Automatic_Variables.
| Tipo: | String |
| Alias: | PSPath |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Puede canalizar una cadena de ruta de acceso a este cmdlet.
Salidas
Este cmdlet crea un archivo que contiene los alias exportados.
Notas
Cuando se usa un archivo de consola (.psc1) para iniciar la sesión, el nombre del archivo de consola se almacena automáticamente en la variable automática $ConsoleFileName. El valor de $ConsoleFileName se actualiza cuando se usa el parámetro Path de Export-Console para especificar un nuevo archivo de consola. Cuando no se usa ningún archivo de consola, $ConsoleFileName no tiene ningún valor ($Null).
Para usar un archivo de consola de Windows PowerShell en una nueva sesión, use la sintaxis siguiente para iniciar Windows PowerShell:
powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1También puede guardar complementos de Windows PowerShell para sesiones futuras agregando un comando Add-PSSnapin al perfil de Windows PowerShell. Para obtener más información, consulte about_Profiles.