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

Export-Console

Модуль:
Microsoft.PowerShell.Core Module

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

Синтаксис

Default (По умолчанию) 

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, а затем используйте параметр PSConsoleFilepowershell.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 без значения параметра пути.

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

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

Свойства параметров

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-NoClobber

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:NoOverwrite

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Path

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

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

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

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:PSPath

Наборы параметров

(All)
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметров

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

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.