Поделиться через

Export-Console

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Экспортирует имена оснастки в текущем сеансе в файл консоли.

Синтаксис

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. Экспорт имен оснастки в последний файл консоли

PS C:\> Export-Console

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

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

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

PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

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

Первая команда использует командлет add-PSSnapin 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. Определение файла консоли для обновления

PS C:\> powershell.exe -PSConsoleFile Console01.psc1
PS C:\> Add-PSSnapin MySnapin
PS C:\> Export-Console NewConsole.psc1
PS C:\> $ConsoleFileName
PS C:\> Add-PSSnapin SnapIn03
PS C:\> Export-Console

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

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

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

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

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

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

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

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Указывает, что этот командлет перезаписывает данные в файле консоли без предупреждения, даже если файл имеет атрибут только для чтения. Атрибут только для чтения изменяется и не сбрасывается после завершения команды.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NoClobber

Указывает, что этот командлет не перезаписывает существующий файл консоли. По умолчанию, если файл возникает в указанном пути, export-Console перезаписывает файл без предупреждения.

Тип:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Указывает путь и имя файла для файла консоли (*.psc1). Введите необязательный путь и имя. Подстановочные знаки не разрешены.

Если указать только имя файла, export-Console создает файл с таким именем и расширением имени PSC1 в текущем каталоге.

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

Если этот параметр не указан, export-Console перезаписывает файл консоли, который использовался в последнем сеансе. Путь к последнему используемому файлу консоли хранится в значении автоматической переменной $ConsoleFileName. Дополнительные сведения см. в about_Automatic_Variables.

Тип:String
Aliases:PSPath
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

String

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

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

FileInfo

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

Примечания

  • При использовании файла консоли (PSC1) для запуска сеанса имя файла консоли автоматически сохраняется в $ConsoleFileName автоматической переменной. Значение $ConsoleFileName обновляется при использовании параметра пути export-Console для указания нового файла консоли. Если файл консоли не используется, $ConsoleFileName не имеет значения ($Null).

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

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

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