Import-PSSession

Import-PSSession [-Session] <PSSession> [[-CommandName] <string[]>] [[-FormatTypeName] <string[]>] [-AllowClobber] [-ArgumentList <Object[]>] [-CommandType {<Alias> | <Function> | <Filter> | <Cmdlet> | <ExternalScript> | <Application> | <Script> | <All>}] [-Module <string[]>] [-Prefix <string>] [<CommonParameters>]

C:\PS>$s = new-pssession -computername Server01

C:\PS> import-pssession -session $s

Описание
-----------
Эта команда импортирует в текущий сеанс все команды из сеанса PSSession на компьютере Server01, кроме команд, имена которых совпадают с именами команд в текущем сеансе. 

Поскольку в этой команде не используется параметр CommandName, она также импортирует все данные форматирования, необходимые импортируемым командам.

C:\PS>$s = new-pssession https://ps.testlabs.com/powershell

C:\PS> import-pssession -session $s -commandname *-test -formatTypeName *

C:\PS> new-test -name test1

C:\PS> get-test test1 | run-test

Описание
-----------
Эти команды импортируют в локальный сеанс команды с именами, заканчивающимися на "-test", и демонстрируют использование импортированного командлета.

Первая команда с помощью командлета New-PSSession создает сеанс PSSession. Она сохраняет сеанс PSSession в переменной $s.

Вторая команда с помощью командлета Import-PSSession импортирует команды из сеанса PSSession в переменной $s в текущий сеанс. Для задания команд с существительным "Test" используется параметр CommandName, а для импорта данных форматирования для этих команд используется параметр FormatTypeName.

The third and fourth commands use the imported commands in the current session. Поскольку импортированные командлеты фактически добавляются в локальный сеанс, для их запуска используется локальный синтаксис. Для выполнения импортированной команды не нужно использовать командлет Invoke-Command.

C:\PS>$s1 = new-pssession -computername s1 

C:\PS> $s2 = new-pssession -computername s2

C:\PS> import-pssession -session s1 -type cmdlet -name New-Test, Get-Test -FormatTypeName *

C:\PS> import-pssession -session s2 -type cmdlet -name Set-Test -FormatTypeName *

C:\PS> new-test Test1 | set-test -runtype full

Описание
-----------
В этом примере показано, что импортированные командлеты можно использовать так же, как и локальные командлеты. 

Эти команды импортируют командлеты New-Test и Get-Test из сеанса PSSession на компьютере Server01 и командлет Set-Test из сеанса PSSession на компьютере Server02. 

Хотя эти командлеты и были импортированы из различных сеансов PSSession, объекты можно по конвейеру передавать из одного командлета в другой без ошибок.

C:\PS>$s = new-pssession -computername Server01

C:\PS> import-pssession -session $s -commandname *-test* -formattypename *

C:\PS> $batch = new-test -name Batch -asjob

C:\PS> receive-job $batch

Описание
-----------
В этом примере показано, как выполнить импортированную команду в качестве фонового задания. 

Поскольку импортированные команды могут выполняться дольше, чем локальные команды, командлет Import-PSSession добавляет к каждой импортируемой команде параметр AsJob. Параметр AsJob позволяет выполнять команду в качестве фонового задания.

Первая команда создает сеанс PSSession на компьютере Server01 и сохраняет объект PSSession в переменной $s.

Вторая команда с помощью командлета Import-PSSession импортирует командлеты Test из сеанса PSSession в переменной $s в текущий сеанс.

Третья команда использует параметр AsJob импортированного командлета New-Test для запуска команды New-Test в качестве фонового задания. Команда сохраняет объект задания, возвращенный командлетом New-Test, в переменной $batch.

Четвертая команда использует командлет Receive-Job для получения результатов задания в переменной $batch.

C:\PS>$s = new-pssession -comp Server01

C:\PS> invoke-command -session $s {import-module TestManagement}

C:\PS> import-pssession -session $s -module TestManagement

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

Первая команда создает сеанс PSSession на компьютере Server01 и сохраняет его в переменной $s. 

Вторая команда использует командлет Invoke-Command для выполнения команды Import-Module в сеансе PSSession, указанном в переменной $s.

Обычно модуль добавляется во все сеансы с помощью команды Import-Module в профиле Windows PowerShell, однако профили не выполняются в сеансах PSSessions.

Третья команда использует параметр Module командлета Import-PSSession, чтобы импортировать в текущий сеанс командлеты и функции из модуля.

C:\PS>import-pssession $s -CommandName Get-Date, SearchHelp  -formatTypeName * -AllowClobber


Name              : tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
Path              : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf\tmp_79468106-4e1d-4d90-af97-1154f9317239_
                    tcw1zunz.ttf.psm1
Description       : Implicit remoting for http://server01.corp.fabrikam.com/wsman
Guid              : 79468106-4e1d-4d90-af97-1154f9317239
Version           : 1.0
ModuleBase        : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
ModuleType        : Script
PrivateData       : {ImplicitRemoting}
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules     : {}

Описание
-----------
В этом примере показано, что командлет Import-PSSession создает модуль во временном файле на диске. Кроме того, в нем показано, что все команды преобразуются в функции, прежде чем они будут импортированы в текущий сеанс.

В этой команде для импорта командлета Get-Date и функции SearchHelp в текущий сеанс используется командлет Import-PSSession. 

Командлет Import-PSSession возвращает объект PSModuleInfo, представляющий временный модуль. Значение свойства Path показывает, что командлет Import-PSSession создал во временной папке файл модуля скрипта (PSM1). Свойство ExportedFunctions показывает, что командлет Get-Date и функция SearchHelp были импортированы в виде функций.

C:\PS>import-pssession $s -CommandName Get-Date -formatTypeName * -AllowClobber

C:\PS> get-command get-date

CommandType   Name       Definition
-----------   ----       ----------
Function      Get-Date   ...
Cmdlet        Get-Date   Get-Date [[-Date] <DateTime>] [-Year <Int32>] [-Month <Int32>]

C:\PS> Get-Date
09074   

C:\PS> (get-command -type cmdlet -name get-date).pssnapin.name
Microsoft.PowerShell.Utility

C:\PS> Microsoft.PowerShell.Utility\get-date

Sunday, March 15, 2009 2:08:26 PM

Описание
-----------
В этом примере показано, как выполнить команду, скрытую импортированной командой.

Первая команда импортирует командлет Get-Date из сеанса PSSession в переменной $s. Поскольку текущий сеанс включает командлет Get-Date, в команде необходимо указать параметр AllowClobber.

Вторая команда с помощью командлета Get-Command получает команды Get-Date в текущем сеансе. Выходные данные показывают, что сеанс включает исходный командлет Get-Date и функцию Get-Date. Функция Get-Date выполняет импортированный командлет Get-Date в сеансе PSSession в переменной $s.

Третья команда выполняет команду Get-Date. Поскольку функции имеют приоритет перед командлетами, Windows PowerShell выполняет импортированную функцию Get-Date, которая возвращает юлианскую дату.

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

Четвертая команда получает имя оснастки Windows PowerShell, которая добавила в текущий сеанс исходный командлет Get-Date.

Пятая команда с помощью заданного оснасткой полного имени командлета Get-Date выполняет команду Get-Date.

Дополнительные сведения о приоритете команд и скрытых командах см. в разделе about_Command_Precedence.

C:\PS>import-pssession -session $s -commandName *Item* -AllowClobber

Описание
-----------
Эта команда импортирует команды, имена которых включают слово "Item", из сеанса PSSession в переменной $s. Поскольку команда включает параметр CommandName, но не включает параметр FormatTypeData, импортируется только команда.

Это команду следует использовать, если для выполнения команды на удаленном компьютере используется командлет Import-PSSession, а в текущем сеансе уже имеются данные форматирования для команды.

C:\PS>$m = import-pssession -session $s -CommandName *bits* -formattypename *bits*

C:\PS> get-command -module $m

CommandType     Name
-----------     ----
Function        Add-BitsFile
Function        Complete-BitsTransfer
Function        Get-BitsTransfer
Function        Remove-BitsTransfer
Function        Resume-BitsTransfer
Function        Set-BitsTransfer
Function        Start-BitsTransfer
Function        Suspend-BitsTransfer

Описание
-----------
Эта команда показывает, как с помощью параметра Module командлета Get-Command определить, какие команды были импортированы в сеанс с помощью команды Import-PSSession.

Первая команда с помощью командлета Import-PSSession импортирует из сеанса PSSession в переменной $s команды, имена которых включают слово "bits". Команда Import-PSSession возвращает временный модуль и сохраняет его в переменной $m.

Вторая команда с помощью командлета Get-Command получает команды, экспортированные модулем в переменной $m. 

Параметр Module принимает строковое значение, которое обозначает имя модуля. Однако при отправке объекта модуля Windows PowerShell использует метод ToString объекта модуля, возвращающий имя модуля. 

Команда Get-Command эквивалентна команде "get-command $m.name".