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 en 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, vea 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 de la sesión actual al archivo ConsoleS1.psc1 de 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
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
Add-PSSnapin NewPSSnapin
Export-Console -Path NewPSSnapinConsole.psc1
powershell.exe -PSConsoleFile NewPsSnapinConsole.psc1Estos comandos agregan el NewPSSnapin complemento 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 de la sesión actual al archivo Console01.psc1 del 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
powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
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 Export-Console sin un valor de parámetro Path.
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, vea 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$ConsoleFileNamese actualiza cuando se usa el parámetro Path deExport-Consolepara 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-PSSnapinal perfil de Windows PowerShell. Para obtener más información, vea about_Profiles.
