Import-Module [-Name] <string[]> [-Alias <string[]>] [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Force] [-Function <string[]>] [-Global] [-PassThru] [-Prefix <string>] [-Variable <string[]>] [-Version <Version>] [<CommonParameters>]

Import-Module [-Сборка] <Assembly[]> [-Alias <string[]>] [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Force] [-Function <string[]>] [-Global] [-PassThru] [-Prefix <string>] [-Variable <string[]>] [-Version <Version>] [<CommonParameters>]

Import-Module [-ModuleInfo] <PSModuleInfo[]> [-Alias <string[]>] [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Force] [-Function <string[]>] [-Global] [-PassThru] [-Prefix <string>] [-Variable <string[]>] [-Version <Version>] [<CommonParameters>]

C:\PS>import-module -name BitsTransfer

Описание
-----------
Эта команда импортирует элементы модуля BitsTransfer в текущий сеанс.

Имя параметра Name (-Name) не является обязательным и может быть опущено.

По умолчанию командлет Import-Module не формирует никаких выходных данных при импорте модуля. Чтобы обеспечить формирование выходных данных, используйте параметр PassThru или AsCustomObject либо общий параметр Verbose.

C:\PS>get-module -listAvailable | import-module

Описание
-----------
Этак команда импортирует все доступные модули в пути, указанном переменной среды PSModulePath ($env:psmodulepath), в текущий сеанс.

C:\PS>$m = get-module -ListAvailable BitsTransfer, ServerBackup

C:\PS> import-module -moduleInfo $m

Описание
-----------
Эти команды импортируют элементы модулей BitsTransfer и ServerBackup в текущий сеанс. 

Первая команда использует командлет Get-Module для получения объектов PSModuleInfo, представляющих модули BitsTransfer и ServerBackup. Она сохраняет объекты в переменной $m. Параметр ListAvailable является обязательным при получении модулей, пока не импортированных в сеанс.

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

Эти команды эквиваленты использованию оператора конвейера (|) для передачи выходных данных команды Get-Module командлету Import-Module.

C:\PS>import-module -name c:\ps-test\modules\test -verbose

VERBOSE: Loading module from path 'C:\ps-test\modules\Test\Test.psm1'.
VERBOSE: Exporting function 'my-parm'.
VERBOSE: Exporting function 'get-parm'.
VERBOSE: Exporting function 'get-spec'.
VERBOSE: Exporting function 'get-specDetails'.

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

Она также использует общий параметр Verbose для получения списка элементов, импортированных из модуля. При вызове параметров Verbose, PassThru или AsCustomObject командлет Import-Module не формирует никаких выходных данных при импорте модуля.

C:\PS>import-module BitsTransfer -cmdlet Add-BitsTransferFile, Get-BitsTransfer

C:\PS> get-module BitsTransfer

Name			: BitsTransfer
Path			: C:\Windows\system32\WindowsPowerShell\v1.0\Modules\BitsTransfer\BitsTransfer.psd1
Description	 :
Guid			: 8fa5064b-8479-4c5c-86ea-0d311fe48875
Version		 : 1.0.0.0
ModuleBase		: C:\Windows\system32\WindowsPowerShell\v1.0\Modules\BitsTransfer
ModuleType		: Manifest
PrivateData	 :
AccessMode		: ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {[Add-BitsTransfer, Add-BitsTransfer], [Complete-BitsTransfer, Complete-BitsTransfer], [Get-BitsTransfer, Get-BitsTransfer], [Rem
					ove-BitsTransfer, Remove-BitsTransfer]...}
ExportedFunctions : {}
ExportedVariables : {}
NestedModules	 : {Microsoft.BackgroundIntelligentTransfer.Management}


C:\PS> get-command -module BitsTransfer

CommandType Name				Definition
----------- ----				----------
Cmdlet	Add-BitsTransfer	Add-BitsTransfer [-BitsJob] <BitsJob[]> [-Source] <String[]> [[-Destination] <String[]>] [-Verbose] [-Debug] [-ErrorA...
Cmdlet	Get-BitsTransfer	Get-BitsTransfer [[-Name] <String[]>] [-AllUsers] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningActi...

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

Первая команда импортирует только командлеты Add-BitsTransfer и Get-BitsTransfer из модуля BitsTransfer. Эта команда использует параметр Cmdlet для ограничения командлетов, импортируемых модулем. Параметры Alias, Variable и Function также можно использовать для ограничения других элементов, импортируемых модулем.

Вторая команда использует командлет Get-Module для получения объекта, представляющего модуль BitsTransfer. В свойстве ExportedCmdlets перечислены все командлеты, экспортируемые модулем, даже если не все они были импортированы.

Третья команда использует параметр Module командлета Get-Command для получения команд, импортированных из модуля BitsTransfer. Результаты подтверждают, что были импортированы только командлеты Add-BitsTransfer и Get-BitsTransfer.

C:\PS>import-module BitsTransfer -prefix PS -passthru

Name			: bitstransfer
Path			: C:\Windows\system32\WindowsPowerShell\v1.0\Modules\bitstransfer\bitstransfer.psd1
Description	 :
Guid			: 8fa5064b-8479-4c5c-86ea-0d311fe48875
Version		 : 1.0.0.0
ModuleBase		: C:\Windows\system32\WindowsPowerShell\v1.0\Modules\bitstransfer
ModuleType		: Manifest
PrivateData	 :
AccessMode		: ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {[Add-BitsTransfer, Add-BitsTransfer], [Remove-BitsTransfer, Remove-BitsTransfer], [Complete-BitsTransfer, Complete-BitsTransfer]
					, [Get-BitsTransfer, Get-BitsTransfer]...}
ExportedFunctions : {}
ExportedVariables : {}
NestedModules	 : {Microsoft.BackgroundIntelligentTransfer.Management}


C:\PS> get-command -module bitstransfer

CommandType	 Name						Definition
-----------	 ----						----------
Cmdlet		Add-PSBitsTransfer		Add-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Source] <String[]> ...
Cmdlet		Complete-PSBitsTransfer	 Complete-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Verbose] [-Deb...
Cmdlet		Get-PSBitsTransfer		Get-PSBitsTransfer [[-Name] <String[]>] [-AllUsers] [-Verbose] ...
Cmdlet		Remove-PSBitsTransfer	 Remove-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Verbose] [-Debug...
Cmdlet		Resume-PSBitsTransfer	 Resume-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Asynchronous] [-...
Cmdlet		Set-PSBitsTransfer		Set-PSBitsTransfer [-BitsJob] <BitsJob[]> [-DisplayName <String...
Cmdlet		Start-PSBitsTransfer		Start-PSBitsTransfer [[-Source] <String[]>] [[-Destination] <St...
Cmdlet		Suspend-PSBitsTransfer	Suspend-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Verbose] [-Debu...

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

Первая команда импортирует модуль BitsTransfer с помощью командлета Import-Module. Она использует параметр Prefix для добавления префикса PS ко всем элементам, импортированным из модуля, и параметр PassThru для возврата объекта модуля, представляющего импортированный модуль.

Объект модуля, возвращаемого командой, имеет свойство ExportedCmdlets, в котором перечисляются экспортированные элементы. Префикс не отображается в именах командлетов, поскольку он применяется после экспорта элементов (но перед импортом элементов).

Вторая команда использует командлет Get-Command для получения элементов, импортированных из модуля. Для указания модуля используется параметр Module. В выходных данных отображаются элементы модуля с именами, к которым добавлен префикс.

Префикс применяется к именам элементов только в рамках текущего сеанса. Он не изменяет содержимое модуля.

C:\PS>get-module -list | format-table -property name, moduletype -auto

Name		ModuleType
----		----------
Show-Calendar	 Script
BitsTransfer	Manifest
PSDiagnostics   Manifest
TestCmdlets	 Script

C:\PS> $a = import-module -name Show-Calendar -asCustomObject

C:\PS> $a | get-member 


   TypeName: System.Management.Automation.PSCustomObject

Name		MemberType   Definition
----		----------   ----------
Equals		Method	 bool Equals(System.Object obj)
GetHashCode   Method	 int GetHashCode()
GetType	 Method	 type GetType()
ToString	Method	 string ToString()
Show-Calendar ScriptMethod System.Object Show-Calendar();

C:\PS> $a."show-calendar"()

Описание
-----------
В этих командах показано, как получать и использовать пользовательский объект, возвращаемый командлетом Import-Module. 

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

Пользовательские объекты очень удобны при создании скриптов. Они также удобны при совпадении имен нескольких импортированных объектов. Использование метода-скрипта объекта эквивалентно указанию полного имени импортированного элемента, включая имя модуля.

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

Первая команда получает все доступные модули с помощью командлета Get-Module. Команда использует оператор конвейера (|) для передачи объектов модулей командлету Format-Table, который отображает в таблице значения параметров Name и ModuleType для каждого модуля.

Вторая команда импортирует модуль-скрипт ShowCalendar с помощью командлета Import-Module. Параметр AsCustomObject используется для формирования пользовательского объекта. Полученный пользовательский объект сохраняется в переменной $a.

Третья команда с помощью оператора конвейера передает переменную $a командлету Get-Member, который получает свойства и методы объекта PSCustomObject, сохраненного в переменной $a. В выходных данных отображается метод-скрипт Show-Calendar.

Последняя команды использует метод-скрипт Show-Calendar. Имя метода должно быть заключено в кавычки, поскольку оно содержит дефис.

C:\PS>import-module BitsTransfer

C:\PS> import-module BitsTransfer -force -prefix PS

Описание
-----------
В этом примере показано, как использовать параметр Force командлета Import-Module при повторном импорте модуля в тот же сеанс. 

Первая команда импортирует модуль BitsTransfer. Вторая команда повторно импортирует модуль, на этот раз с указанием параметра Prefix. 

Во второй команде также задан параметр Force, который удаляет модуль и снова импортирует его. Без этого параметра сеанс содержал бы две копии каждого командлета BitsTransfer: одну копию со стандартным именем, а вторую — с именем с префиксом.

C:\PS>get-date

Saturday, September 12, 2009 6:47:04 PM

C:\PS> import-module TestModule

C:\PS> get-date
09255

C:\PS> get-command get-date | format-table -property commandtype, name, pssnapin, module -auto

CommandType  Name	 pssnapin					 Module
-----------  ----	 --------					 ------
   Function  Get-Date								TestModule
	 Cmdlet  Get-Date   Microsoft.PowerShell.Utility


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

Saturday, September 12, 2009 6:33:23 PM

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

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

Вторая команда импортирует модуль TestModule. В этот модуль входит функция Get-Date, которая возвращает дату по юлианскому календарю. 

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

Четвертая команда показывает, что в сеансе имеется две команды Get-Date, функция из модуля TestModule и командлет из оснастки Microsoft.PowerShell.Utility.

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

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