Export-Console

Синтаксис

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Export-Console экспортирует имена оснастки Windows PowerShell в текущем сеансе в файл консоли Windows PowerShell (PSC1). Можно использовать этот командлет, чтобы сохранить оснастки для использования в последующих сеансах.

Чтобы добавить оснастки в файл консоли PSC1 в сеанс, запустите Windows PowerShell (PowerShell.exe) в командной строке с помощью Cmd.exe или другого сеанса Windows PowerShell, а затем используйте параметр PSConsoleFile PowerShell.exe, чтобы указать файл консоли.

Дополнительные сведения о оснастки Windows PowerShell см. в about_PSSnapins.

Примеры

Пример 1. Экспорт имен оснастки в текущем сеансе

PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1

Эта команда экспортирует имена оснастки Windows PowerShell в текущем сеансе ConsoleS1.psc1 в файл в папке "Консоли" папки установки Windows PowerShell. $pshome

Пример 2. Экспорт имен оснастки в последний файл консоли

Export-Console

Эта команда экспортирует имена оснасток Windows PowerShell из текущего сеанса в файл консоли Windows PowerShell, который использовался в текущем сеансе последним. Содержимое файла перезаписывается.

Если экспорт файла консоли в текущем сеансе не производился, пользователю предлагается подтвердить выполнение команды, а затем ввести имя файла.

Пример 3. Добавление оснастки и экспорт имен оснастки

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Эти команды добавляют оснастку NewPSSnapin Windows PowerShell в текущий сеанс, экспортируйте имена оснастки Windows PowerShell в текущем сеансе в файл консоли, а затем запустите сеанс Windows PowerShell с помощью файла консоли.

Первая команда использует Add-PSSnapin командлет для добавления оснастки NewPSSnapin в текущий сеанс. Добавлять можно только те оснастки Windows PowerShell, которые зарегистрированы в данной системе.

Вторая команда экспортирует имена оснастки Windows PowerShell в NewPSSnapinConsole.psc1 файл.

Третья команда запускает Windows PowerShell с файлом NewPSSnapinConsole.psc1 . Поскольку файл консоли включает имя оснастки Windows PowerShell, в текущем сеансе можно использовать командлеты и поставщики, которые поддерживаются оснасткой.

Пример 4. Экспорт имен оснастки в указанное расположение

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>

Эта команда экспортирует имена оснастки Windows PowerShell в текущем сеансе Console01.psc1 в файл в текущем каталоге.

Вторая команда отображает содержимое Console01.psc1 файла в Блокноте.

Пример 5. Определение файла консоли для обновления

powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-Console

В этом примере показано, как использовать $ConsoleFileName автоматическую переменную для определения файла консоли, который будет обновляться при использовании Export-Console без значения параметра Path .

Первая команда использует параметр PSConsoleFile PowerShell.exe для открытия Windows PowerShell с файлом Console01.psc1 .

Вторая команда использует Add-PSSnapin командлет для добавления оснастки Windows PowerShell MySnapin в текущий сеанс.

Третья команда использует Export-Console командлет для экспорта имен всех оснастки Windows PowerShell в сеансе NewConsole.psc1 в файл.

Четвертая команда отображает $ConsoleFileName переменную. Он содержит последний использованный файл консоли. Пример выходных данных показывает, что последним использовался файл NewConsole.ps1.

Пятая команда добавляет в текущую консоль оснастку SnapIn03.

Шестая команда использует Export-Console командлет без параметра Path . Эта команда экспортирует имена всех оснастки Windows PowerShell в текущем сеансе в последний используемый файл NewConsole.psc1.

Параметры

-Confirm

-Force

-NoClobber

-Path

-WhatIf

Входные данные

String

Строку пути можно передать в этот командлет по конвейеру.

Выходные данные

FileInfo

Этот командлет создает файл, содержащий экспортированные псевдонимы.

Примечания

• Если консольный файл (.psc1) используется для запуска сеанса, имя файла консоли автоматически сохраняется в автоматической переменной $ConsoleFileName . Значение $ConsoleFileName обновляется при использовании параметра Path для Export-Console указания нового файла консоли. Если файл консоли не используется, $ConsoleFileName не имеет значения ($null).

  Чтобы использовать файл консоли Windows PowerShell в новом сеансе, запустите Windows PowerShell с помощью следующего синтаксиса:

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

  Оснастки Windows PowerShell можно также сохранить для будущих сеансов, добавив команду Add-PSSnapin в профиль Windows PowerShell. Дополнительные сведения см. в разделе about_Profiles.

Связанные ссылки

• Add-PSSnapin
• Get-PSSnapin
• Remove-PSSnapin