Export-Console
Exporta los nombres de los complementos en la sesión actual a un archivo de consola.
Sintaxis
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
El Export-Console cmdlet 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 y usarlos en futuras sesiones.
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 ConsoleS1.psc1 archivo 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 desde la sesión actual al archivo de consola de Windows PowerShell usado 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 pide permiso para continuar y, a continuación, se le pide 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 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 Add-PSSnapin cmdlet para agregar el complemento NewPSSnapin a la sesión actual. Sólo puede agregar complementos de Windows PowerShell que estén registrados en su sistema.
El segundo comando exporta los nombres de complemento de Windows PowerShell al NewPSSnapinConsole.psc1 archivo.
El tercer comando inicia Windows PowerShell con el NewPSSnapinConsole.psc1 archivo . Dado que el archivo de consola incluye el nombre de 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 Console01.psc1 archivo del directorio actual.
El segundo comando muestra el contenido del archivo en el Console01.psc1 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 $ConsoleFileName variable automática 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 Console01.psc1 archivo .
El segundo comando usa el Add-PSSnapin cmdlet para agregar el complemento MySnapin de Windows PowerShell a la sesión actual.
El tercer comando usa el Export-Console cmdlet para exportar los nombres de todos los complementos de Windows PowerShell de la sesión al NewConsole.psc1 archivo.
El cuarto comando muestra la $ConsoleFileName variable . Contiene el archivo de consola usado más recientemente. Los resultados de ejemplo muestran que NewConsole.ps1 es el último archivo usado.
El quinto comando agrega SnapIn03 a la consola actual.
El sexto comando usa el Export-Console cmdlet 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 solicita su 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 admite el uso de 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 se ejecutara el cmdlet. 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$ConsoleFileNamevariable automática. El valor de se actualiza cuando se usa el parámetro Path de para especificar un nuevo archivo de$ConsoleFileNameExport-Consoleconsola. 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 siguiente sintaxis para iniciar Windows PowerShell:
powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1También puede guardar los complementos de Windows PowerShell para futuras sesiones agregando un comando Add-PSSnapin a su perfil de Windows PowerShell. Para obtener más información, consulte about_Profiles.
