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


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

Запрос подтверждения перед выполнением командлета.

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

-Force

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

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

-NoClobber

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

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

-Path

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

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

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

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

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

-WhatIf

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

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

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

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.