Экспортирует имена оснасток в текущем сеансе в файл консоли.
Синтаксис
Export-Console [[-Path] <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Export-Console экспортирует имена оснасток Windows PowerShell (PSSnapin) в текущем сеансе в файл консоли Windows PowerShell (PSC1). Можно использовать этот командлет, чтобы сохранить оснастки для использования в последующих сеансах.
Чтобы добавить оснастку в файл консоли PSC1 для сеанса, запустите Windows PowerShell (Powershell.exe) из командной строки с помощью Cmd.exe или другого сеанса Windows PowerShell и воспользуйтесь параметром PSConsoleFile при вызове Powershell.exe для указания файла консоли.
Дополнительные сведения об оснастках Windows PowerShell см в разделе about_Pssnapins.
Параметры
-Force
Перезаписывает данные в файле консоли без предупреждения, даже если файл имеет атрибут "только для чтения". Атрибут "только для чтения" изменяется и не восстанавливается после завершения команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-NoClobber
Не будет перезаписывать существующий файл консоли (то есть заменять его содержимое). По умолчанию, если файл существует по указанному пути, командлет Export-Console перезаписывает файл без предупреждения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Path <string>
Указывает путь и имя файла для файла консоли (*.psc1). Введите путь (необязательно) и имя. Подстановочные знаки запрещены.
Если введено только имя файла, командлет Export-Console создает файл с этим именем и расширением ".psc1" в текущем каталоге.
Этот параметр является обязательным, если Windows PowerShell не был запущен с параметром PSConsoleFile или в течение текущего сеанса не экспортировался файл консоли. Он также требуется, если для предотвращения перезаписи текущего файла консоли используется параметр NoClobber.
Если пропустить этот параметр, командлет Export-Console перезаписывает (заменяет содержимое) последнего файла консоли, использовавшегося во время этого сеанса. Путь к последнему использовавшемуся файлу консоли сохраняется в автоматической переменной $ConsoleFilename. Дополнительные сведения см. в разделе about_Automatic_Variables.
|
Обязательно? |
false |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue, ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.String Можно передать строку пути командлету Export-Console по конвейеру. |
|
Выходные данные |
System.IO.FileInfo Export-Console создает файл, содержащий экспортированные псевдонимы. |
Примечания
Если для создания сеанса используется файл консоли (PSC1), имя файла консоли автоматически сохраняется в автоматической переменной $ConsoleFilename. При использовании параметра Path командлета Export-Console для указания нового файла консоли значение переменной $ConsoleFilename обновляется. Если файл консоли не используется, значение переменной $ConsoleFileName не определено ($null).
Чтобы использовать файл консоли Windows PowerShell в новом сеансе, команда запуска Windows PowerShell должна иметь следующий формат:
"powershell.exe -PsConsoleFile <файл консоли>.psc1".
Можно также сохранить оснастки Windows PowerShell для использования в будущих сеансах, добавив команду Add-PSSnapin в свой профиль Windows PowerShell. Дополнительные сведения см. в разделе about_Profiles.
Пример 1
C:\PS>export-console -path $pshome\Consoles\ConsoleS1.psc1 Описание ----------- Эта команда экспортирует имена оснасток Windows PowerShell в текущем сеансе в файл ConsoleS1.psc1 в подкаталоге Consoles каталога установки Windows PowerShell, $pshome.
Пример 2
C:\PS>export-console Описание ----------- Эта команда экспортирует имена оснасток Windows PowerShell из текущего сеанса в файл консоли Windows PowerShell, который использовался во время текущего сеанса последним. Содержимое файла будет перезаписано. Если экспорт консоли в текущем сеансе не производился, пользователю предлагается подтвердить выполнение команды, а затем ввести имя файла.
Пример 3
C:\PS>add-pssnapin NewPSSnapin C:\PS> export-console -path NewPSSnapinConsole.psc1 C:\PS> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1 Описание ----------- Эти команды добавляют новую оснастку Windows PowerShell NewPSSnapin в текущий сеанс, экспортируют имена оснасток Windows PowerShell в текущем сеансе в файл консоли и запускают сеанс Windows PowerShell с использованием файла консоли. Первая команда добавляет новую оснастку NewPSSnapin в текущий сеанс при помощи командлета Add-PSSnapin. Добавлять можно только те оснастки Windows PowerShell, которые зарегистрированы в данной системе. Вторая команда экспортирует имена оснасток Windows PowerShell в файл NewPSSnapinConsole.psc1. Третья команда запускает Windows PowerShell с использованием файла NewPSSnapinConsole.psc1. Поскольку в файл консоли добавлено имя надстройки Windows PowerShell, в текущем сеансе можно использовать командлеты и поставщики, которые поддерживаются оснасткой.
Пример 4
C:\PS>export-console -path Console01
C:\PS> 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
C:\PS>powershell.exe -PSConsoleFile Console01.psc1 C:\PS> add-pssnapin MySnapin C:\PS> export-console NewConsole.psc1 C:\PS> $consolefilename C:\PS> add-pssnapin SnapIn03 C:\PS> export-console Описание ----------- В этом примере демонстрируется использование автоматической переменной $ConsoleFileName для определения файла консоли, который будет обновлен при вызове командлета Export-Console без параметра Path. В первой команде используется параметр PSConsoleFile файла PowerShell.exe, позволяющий запустить Windows PowerShell с файлом консоли Console01.psc1. Во второй команде оснастка MySnapin Windows PowerShell добавляется в текущий сеанс с использованием командлета Add-PSSnapin. В третьей команде имена всех оснасток Windows PowerShell в сеансе экспортируются в файл NewConsole.psc1 с использованием командлета Export-Console. В четвертой команде параметр $ConsoleFilename используется для отображения последнего использовавшегося файла консоли. Пример выходных данных показывает, что последним использовался файл NewConsole.ps1. В пятой команде в текущую консоль добавляется оснастка SnapIn03. В шестой команде выполняется вызов командлета ExportConsole без параметра Path. Эта команда экспортирует имена всех оснасток Windows PowerShell в текущем сеансе в последний использовавшийся файл NewConsole.psc1.
См. также