Exporta los nombres de complementos de la sesión actual a un archivo de consola.
Sintaxis
Export-Console [[-Path] <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
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 su utilización en sesiones futuras.
Para agregar los complementos del archivo de consola .psc1 a una sesión, inicie Windows PowerShell (Powershell.exe) en la línea de comandos por medio de Cmd.exe o de 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.
Parámetros
-Force
Sobrescribe los datos de un archivo de consola sin avisar, aunque el archivo tenga el atributo de solo lectura. El atributo de solo lectura se modifica y no se restablece cuando finaliza la ejecución del comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-NoClobber
No se sobrescribirá un archivo de consola existente (es decir, no remplazará su contenido). De forma predeterminada, si existe un archivo en la ruta de acceso especificada, Export-Console sobrescribe el archivo sin avisar.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Path <string>
Especifica una ruta de acceso y un nombre de archivo para el archivo de consola (*.psc1). Escriba una ruta de acceso (opcional) y un nombre. No se permite el uso de caracteres comodín.
Si escribe solamente un nombre de archivo, Export-Console creará un archivo con ese nombre y la extensión de nombre de archivo ".psc1" en el directorio actual.
Este parámetro es obligatorio, 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 si usa el parámetro NoClobber para evitar que se sobrescriba el archivo de consola actual.
Si omite este parámetro, Export-Console sobrescribirá (reemplazará el contenido) del último archivo de consola usado en esta sesión. La ruta de acceso al último archivo de consola usado se almacenará en el valor de la variable automática $ConsoleFileName. Para obtener más información, vea about_Automatic_Variables.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿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 |
System.String Se puede canalizar una cadena de ruta de acceso a Export-Console. |
|
Salidas |
System.IO.FileInfo Export-Console crea un archivo que contiene los alias exportados. |
Notas
Cuando un archivo de consola (.psc1) se utiliza para iniciar la sesión, su nombre se almacena automáticamente en la variable automática $ConsoleFileName. El valor de $ConsoleFileName se actualiza al utilizar el parámetro Path de Export-Console para especificar un nuevo archivo de consola. Cuando no se utiliza 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, debe usarse la siguiente sintaxis a fin de iniciar Windows PowerShell:
"powershell.exe -PsConsoleFile <archivoConsola>.psc1".
También se pueden guardar complementos de Windows PowerShell para sesiones futuras agregando un comando Add-PSSnapin al perfil de Windows PowerShell. Para obtener más información, vea about_Profiles.
Ejemplo 1
C:\PS>export-console -path $pshome\Consoles\ConsoleS1.psc1 Descripción ----------- Este comando exporta los nombres de los complementos de Windows PowerShell de la sesión actual al archivo ConsoleS1.psc1 en el subdirectorio Consoles del directorio de instalación de Windows PowerShell, $pshome.
Ejemplo 2
C:\PS>export-console Descripción ----------- Este comando exporta los nombres de los complementos de Windows PowerShell de la sesión actual al último archivo de consola de Windows PowerShell usado 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, un nombre de archivo.
Ejemplo 3
C:\PS>add-pssnapin NewPSSnapin C:\PS> export-console -path NewPSSnapinConsole.psc1 C:\PS> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1 Descripción ----------- Estos comandos agregan el complemento NewPSSnapin de Windows PowerShell a la sesión actual, exportan los nombres de los complementos de Windows PowerShell de 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 se pueden agregar complementos de Windows PowerShell registrados en el sistema. El segundo comando exporta los nombres de los complementos 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 los proveedores del complemento estarán disponibles en la sesión actual.
Ejemplo 4
C:\PS>export-console -path Console01
C:\PS> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
<PSVersion>2.0</PSVersion>
<PSSnapIns>
<PSSnapIn Name="NewPSSnapin" />
</PSSnapIns>
</PSConsoleFile>
Descripción
-----------
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 Notepad (Bloc de notas).
Ejemplo 5
C:\PS>powershell.exe -PSConsoleFile Console01.psc1 C:\PS> add-pssnapin MySnapin C:\PS> export-console NewConsole.psc1 C:\PS> $consolefilename C:\PS> add-pssnapin SnapIn03 C:\PS> export-console Descripción ----------- En este ejemplo se muestra la forma de utilizar la variable automática $ConsoleFileName para determinar el archivo de consola que se actualizará si se utiliza Export-Console sin un valor de parámetro Path. El primer comando utiliza 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 utiliza el parámetro $ConsoleFileName para mostrar el último archivo de consola utilizado. En el resultado de ejemplo se muestra que NewConsole.ps1 es el último archivo utilizado. El quinto comando agrega SnapIn03 a la consola actual. El sexto comando usa el cmdlet ExportConsole sin un parámetro Path. Este comando exporta los nombres de todos los complementos de Windows PowerShell de la sesión actual al último archivo utilizado, NewConsole.psc1.
Vea también