Register-PSSessionConfiguration

Register-PSSessionConfiguration [-AssemblyName] <string> [-ConfigurationTypeName] <string> [-ApplicationBase <string>] [-Name] <string> [-Force] [-MaximumReceivedDataSizePerCommandMB <double>] [-MaximumReceivedObjectSizeMB <double>] [-NoServiceRestart] [-ProcessorArchitecture <string>] [-SecurityDescriptorSDDL <string>] [-ShowSecurityDescriptorUI] [-StartupScript <string>] [-ThreadApartmentState {<STA> | <MTA> | <Unknown>}] [-ThreadOptions {<Default> | <UseNewThread> | <ReuseThread> | <UseCurrentThread>}] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>register-pssessionConfiguration -name NewShell -applicationBase c:\MyShells\ -assemblyName MyShell.dll -configurationTypeName MyClass

Описание
-----------
Эта команда регистрирует новую конфигурацию сеанса NewShell. Параметры ApplicationName и ApplicationBase используются для указания местоположения файла MyShell.dll, который задает командлеты и поставщики в конфигурации сеанса. Кроме того, используется параметр ConfigurationTypeName для указания нового класса, используемого для дальнейшей настройки сеанса.

Для использования этой конфигурации пользователи должны будут ввести команду "new-pssession -configurationname newshell".

C:\PS>register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

Описание
-----------
Эта команда регистрирует на локальном компьютере конфигурацию MaintenanceShell. Параметр StartupScript используется для указания скрипта Maintenance.ps1.

Когда пользователь вводит команду New-PSSession и выбирает конфигурацию MaintenanceShell, в новом сеансе выполняется скрипт Maintenance.ps1. Этот скрипт может настраивать сеанс, в том числе импортировать модули, добавлять оснастки Windows PowerShell и задавать политику выполнения для сеанса. Если скрипт выдаст какую-либо ошибку, в том числе непрерывающую, команда New-PSSession завершится неудачей.

C:\PS>$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FA;SA;GWGX;;WD)"

C:\PS> register-pssessionconfiguration -name AdminShell -securityDescriptorSDDL $sddl -maximumReceivedObjectSizeMB 20 -startupScript c:\scripts\AdminShell.ps1

Описание
-----------
Этот пример регистрирует конфигурацию сеанса AdminShell. 

Первая команда сохраняет пользовательскую строку SDDL в переменной $sddl. 

Вторая команда регистрирует новую оболочку. В команде используется параметр SecurityDescritorSDDL для задания строки SDDL из переменной $sddl и параметр MaximumReceivedObjectSizeMB для увеличения ограничения на размер объекта. Кроме того, используется параметр StartupScript для указания скрипта, используемого для настройки параметра.

В качестве альтернативы параметру SecurityDescriptorSDDL можно использовать параметр ShowSecurityDescriptorUI для вывода листа свойств, с помощью которого можно будет задать разрешения для конфигурации сеанса. При нажатии кнопки "ОК" в листе свойств формируется строка SDDL для конфигурации сеанса.

C:\PS>$s = register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

C:\PS> $s

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}


C:\PS> $s.getType().fullname
TypeName: Microsoft.WSMan.Management.WSManConfigContainerElement


C:\PS> $s | format-list -property *

PSPath            : Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell
PSParentPath      : Microsoft.WSMan.Management\WSMan::localhost\Plugin
PSChildName       : MaintenanceShell
PSDrive           : WSMan
PSProvider        : Microsoft.WSMan.Management\WSMan
PSIsContainer     : True
Keys              : {Name=MaintenanceShell}
Name              : MaintenanceShell
TypeNameOfElement : Container


C:\PS> dir wsman:\localhost\plugin

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}

Описание
-----------
Этот пример показывает, что команда Register-PSSessionConfiguration возвращает элемент WSManConfigContainerElement. Также в нем показано, как найти элементы-контейнеры на диске WSMan:.

Первая команда регистрирует конфигурацию сеанса MaintenanceShell с помощью командлета Register-PSSessionConfiguration. Она сохраняет объект, возвращенный командлетом, в переменной $s.

Вторая команда отображает содержимое переменной $s. 

Третья команда с помощью метода GetType и его свойства FullName отображает имя типа объекта, возвращенного командлетом Register-PSSessionConfiguration.

Четвертая команда с помощью командлета Format-List отображает все свойства объекта, возвращенного командлетом Register-PSSessionConfiguration, в виде списка. Из свойства PSPath видно, что объект хранится в каталоге на диске WSMan:.

Пятая команда с помощью командлета Get-ChildItem отображает элементы в папке WSMan:\LocalHost\PlugIn. В этой папке находится новая конфигурация MaintenanceShell и две конфигурации по умолчанию, входящие в комплект Windows PowerShell.

C:\PS>register-pssessionconfiguration -name WithProfile -startupScript add-profile.ps1

# Add-Profile.ps1

. c:\users\admin01\documents\windowspowershell\profile.ps1

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

Также отображается содержимое указанного скрипта (Add-Profile.ps1). Скрипт содержит единственную команду, в которой используется запись с точками для запуска профиля CurrentUserAllHosts пользователя в текущей области сеанса.

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