about_PSSnapins
Краткое описание
Описывает оснастки Windows PowerShell и показывает, как использовать и управлять ими.
Подробное описание
Оснастка Windows PowerShell — это сборка Microsoft платформа .NET Framework, которая может содержать поставщиков и командлетов Windows PowerShell. Windows PowerShell включает набор базовых оснастки, но вы можете расширить возможности и значение Windows PowerShell, добавив оснастки, содержащие поставщиков и командлетов, которые вы создаете или получаете от других пользователей.
При добавлении оснастки командлеты и поставщики, которые он содержит, сразу же доступны для использования в текущем сеансе, но изменение влияет только на текущий сеанс.
Чтобы добавить оснастку во все будущие сеансы, сохраните ее в профиле Windows PowerShell. Можно также использовать Export-Console
командлет для сохранения имен оснастки в файл консоли, а затем использовать сохраненную конфигурацию в будущих сеансах.
Начиная с Windows PowerShell 3.0 командлеты, которые отправляются с Помощью PowerShell, упаковываются в модули. Исключением является Microsoft.PowerShell.Core, который является единственным оставшимся оснасткой. Оснастка Microsoft.PowerShell.Core загружается в каждом сеансе по умолчанию. Остальные модули загружаются автоматически при первом использовании. Дополнительные сведения см. в about_Modules.
Поиск оснастки
Чтобы получить список оснастки Windows PowerShell на компьютере, введите следующее:
Get-PSSnapin
Чтобы получить оснастку для каждого поставщика Windows PowerShell, введите следующее:
Get-PSProvider | Format-List name, pssnapin
Чтобы получить все зарегистрированные оснастки в системе или убедиться, что оснастка зарегистрирована, введите следующее:
Get-PSSnapin -registered
Чтобы получить список командлетов в оснастке Windows PowerShell, введите следующее:
Get-Command -Module <snap-in_name>
Установка оснастки
Встроенные оснастки регистрируются в системе и добавляются в сеанс по умолчанию при запуске Windows PowerShell. Однако необходимо зарегистрировать оснастки, которые вы создаете или получаете от других пользователей, а затем добавлять оснастки в сеанс.
Добавление оснастки в текущий сеанс
Чтобы добавить зарегистрированную оснастку в текущий сеанс, используйте Add-PsSnapin
командлет. Например, чтобы добавить оснастку Microsoft SQL Server в сеанс, введите следующее:
Add-PSSnapin sql
После завершения команды поставщики и командлеты в оснастке доступны в сеансе. Однако они доступны только в текущем сеансе, если вы не сохраните их.
Сохранение оснастки
Чтобы использовать оснастку в будущих сеансах Windows PowerShell, добавьте Add-PsSnapin
команду в профиль Windows PowerShell. Или экспортируйте имена оснастки в файл консоли.
Если вы добавите Add-PSSnapin
команду в профиль, она доступна во всех будущих сеансах Windows PowerShell. Если вы экспортируете имена оснастки в сеансе, вы можете использовать файл экспорта только в том случае, если требуется оснастка.
Чтобы добавить Add-PsSnapin
команду в профиль Windows PowerShell, откройте профиль, вставьте или введите команду, а затем сохраните профиль. Дополнительные сведения см. в разделе about_Profiles.
Чтобы сохранить оснастки из сеанса в файле консоли (.psc1
), используйте Export-Console
командлет. Например, чтобы сохранить оснастки в текущей конфигурации NewConsole.psc1
сеанса в файл в текущем каталоге, введите следующее:
Export-Console NewConsole
Дополнительные сведения см. в статье "Экспорт консоли".
Открытие Windows PowerShell с помощью файла консоли
Чтобы использовать файл консоли, включающий оснастку, запустите Windows PowerShell (powershell.exe
) из командной строки или cmd.exe
в другом сеансе Windows PowerShell. Используйте параметр PsConsoleFile, чтобы указать файл консоли, включающий оснастку. Например, следующая команда запускает Windows PowerShell с файлом NewConsole.psc1
консоли:
PowerShell.exe -psconsolefile NewConsole.psc1
Поставщики и командлеты в оснастке теперь доступны для использования в сеансе.
Удаление оснастки
Чтобы удалить оснастку Windows PowerShell из текущего сеанса Remove-PsSnapin
, используйте командлет. Например, чтобы удалить оснастку SQL Server из текущего сеанса, введите следующее:
Remove-PSSnapin sql
Этот командлет удаляет оснастку из сеанса. Оснастка по-прежнему загружается, но поставщики и командлеты, поддерживаемые им, больше не доступны.
События оснастки журнала
Начиная с Windows PowerShell 3.0, можно записывать события выполнения для командлетов в модулях Windows PowerShell и оснастки, задав для свойства LogPipelineExecutionDetails модули и оснастки $true
в значение .
Дополнительные сведения см. в about_EventLogs.
См. также
PowerShell