Export-Console

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Exporta los nombres de los complementos en la sesión actual a un archivo de consola.

Syntax

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.psc1

Este 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-Console

Este 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.psc1

Estos 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 Console01.psc1 archivo en 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-Console

En 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PSPath
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Puede canalizar una cadena de ruta de acceso a este cmdlet.

Salidas

FileInfo

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 $ConsoleFileName variable automática. El valor de se actualiza cuando se usa el parámetro Path de para especificar un nuevo archivo de $ConsoleFileNameExport-Console 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 siguiente sintaxis para iniciar Windows PowerShell:

    powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

    Tambié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.