Set-PSSessionConfiguration

Синтаксис

NameParameterSet (по умолчанию)

Set-PSSessionConfiguration
    [-Name] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AssemblyNameParameterSet

Set-PSSessionConfiguration
    [-Name] <String>
    [-AssemblyName] <String>
    [-ConfigurationTypeName] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SessionConfigurationFile

Set-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-TransportOption <PSTransportOption>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Создание и изменение конфигурации сеанса

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $null

Пример 2. Отображение результатов

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

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

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "Restart-Service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Пример 3. Отображение результатов различными способами

Set-PSSessionConfiguration -Name "MaintenanceShell" -StartupScript "C:\ps-test\Maintenance.ps1"

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

ParamName            ParamValue
---------            ----------
startupscript        C:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run
the command "Restart-Service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : C:\ps-test\Maintenance.ps1
ResourceUri      : http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript C:\ps-test\Maintenance.ps1

Параметры

-AccessMode

Включает и отключает конфигурацию сеанса и определяет, можно ли использовать для удаленных или локальных сеансов на компьютере. Допустимые значения для этого параметра:

• Disabled. Отключает конфигурацию сеанса. Его нельзя использовать для удаленного или локального доступа к компьютеру. Это значение задает для свойства Enabled конфигурации сеанса (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) значение False.
• Local. Добавляет запись Network_Deny_All в дескриптор безопасности конфигурации сеанса. Пользователи локального компьютера могут использовать конфигурацию сеанса для создания локального сеанса обратного цикла на том же компьютере, но удаленным пользователям запрещен доступ.
• Remote. Удаляет записи Deny_All и Network_Deny_All из дескрипторов безопасности конфигурации сеанса. Пользователи локальных и удаленных компьютеров могут использовать конфигурацию сеанса для создания сеансов и выполнения команд на этом компьютере.

Значение по умолчанию — удаленных.

Другие командлеты могут переопределить значение этого параметра позже. Например, командлет Enable-PSRemoting включает все конфигурации сеансов на компьютере и разрешает удаленный доступ к ним, а командлет Disable-PSRemoting разрешает только локальный доступ ко всем конфигурациям сеансов на компьютере.

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-ApplicationBase

Указывает путь к файлу сборки (*.dll), указанному в значении параметра AssemblyName .

Свойства параметра

Наборы параметров

-AssemblyName

Указывает имя сборки. Этот командлет создает конфигурацию сеанса на основе класса, определенного в сборке.

Введите имя файла или полный путь к файлу сборки .dll , который определяет конфигурацию сеанса. Если ввести только имя файла, введите путь в значение параметра ApplicationBase.

Свойства параметра

Наборы параметров

-ConfigurationTypeName

Указывает тип конфигурации сеанса, определенной в сборке в параметре AssemblyName. Указанный тип должен реализовать класс System.Management.Automation.Remoting.PSSessionConfiguration.

Этот параметр требуется при указании имени сборки.

Свойства параметра

Наборы параметров

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Наборы параметров

-Force

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

Чтобы предотвратить перезапуск и отключить запрос перезапуска, используйте параметр NoServiceRestart.

Свойства параметра

Наборы параметров

-MaximumReceivedDataSizePerCommandMB

Указывает ограничение на объем данных, которые можно отправить на этот компьютер в любой удаленной команде. Введите размер данных в мегабайтах (МБ). Значение по умолчанию — 50.

Если ограничение размера данных определено в типе конфигурации, указанном в параметре configurationType Name , используется ограничение в типе конфигурации. Значение этого параметра игнорируется.

Свойства параметра

Наборы параметров

-MaximumReceivedObjectSizeMB

Указывает ограничения на объем данных, которые можно отправлять на этот компьютер в любом одном объекте. Введите размер данных в мегабайтах. Значение по умолчанию — 10.

Если ограничение размера объекта определено в типе конфигурации, указанном в параметре ConfigurationTypeName, используется ограничение в типе конфигурации. Значение этого параметра игнорируется.

Свойства параметра

Наборы параметров

-ModulesToImport

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

По умолчанию только модуль Microsoft.PowerShell.Core импортируется в сеансы, но если командлеты не исключены, можно использовать Import-Module и Add-PSSnapin командлеты для добавления модулей и оснастки в сеанс.

Модули, указанные в этом значении параметра, импортируются в дополнение к модулям, указанным в файле конфигурации сеанса (New-PSSessionConfigurationFile). Однако параметры в файле конфигурации сеанса могут скрыть команды, экспортированные модулями, или запретить пользователям использовать их.

Модули, указанные в этом значении параметра, заменяют список модулей, указанных параметром ModulesToImport командлета Register-PSSessionConfiguration .

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-Name

Указывает имя конфигурации сеанса, которую требуется изменить.

Этот параметр нельзя использовать для изменения имени конфигурации сеанса.

Свойства параметра

Наборы параметров

-NoServiceRestart

Не перезапускает службу WinRM и подавляет запрос на перезапуск службы.

По умолчанию при запуске Set-PSSessionConfigurationвам будет предложено перезапустить службу WinRM, чтобы создать новую конфигурацию сеанса. Пока служба WinRM не будет перезапущена, новая конфигурация сеанса не действует.

Чтобы перезапустить службу WinRM без запроса, используйте параметр Force. Чтобы перезапустить службу WinRM вручную, используйте командлет .

Свойства параметра

Наборы параметров

-Path

Указывает путь к файлу конфигурации сеанса(.pssc), например файлу конфигурации сеанса, созданному командлетом New-PSSessionConfigurationFile . Если вы опустите путь, по умолчанию используется текущий каталог.

Сведения об изменении файла конфигурации сеанса см. в разделе справки для командлета New-PSSessionConfigurationFile.

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-PSVersion

Указывает версию PowerShell в сеансах, использующих эту конфигурацию сеанса.

Значение этого параметра имеет приоритет над значением ключа PowerShellVersion в файле конфигурации сеанса.

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-RunAsCredential

Задает учетные данные для команд в сеансе. По умолчанию команды выполняются с разрешениями текущего пользователя.

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-SecurityDescriptorSddl

Задает другую строку языка определения дескриптора безопасности (SDDL) для конфигурации.

Эта строка определяет разрешения, необходимые для использования новой конфигурации сеанса. Чтобы использовать конфигурацию сеанса в сеансе, пользователи должны иметь по крайней мере Execute(Invoke) разрешение на настройку.

Чтобы использовать дескриптор безопасности по умолчанию для конфигурации, введите пустую строку ("") или значение $null. По умолчанию используется корневой SDDL на WSMan: диске.

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

Свойства параметра

Наборы параметров

-SessionTypeOption

Задает параметры, относящиеся к типу для конфигурации сеанса. Введите объект параметров типа сеанса, например объект PSWorkflowExecutionOption, возвращаемый командлетом New-PSWorkflowExecutionOption.

Параметры сеансов, использующих конфигурацию сеанса, определяются значениями параметров сеанса и параметрами конфигурации сеанса. Если не указано, параметры, заданные в сеансе, например с командлетом New-PSSessionOption , имеют приоритет над параметрами, заданными в конфигурации сеанса. Однако значения параметров сеанса не могут превышать максимальные значения, заданные в конфигурации сеанса.

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-ShowSecurityDescriptorUI

При использовании этого параметра командлет открывает лист свойств, который помогает создать новый SDDL для конфигурации сеанса. Лист свойств появится после выполнения команды Set-PSSessionConfiguration, а затем перезапустить службу WinRM.

При установке разрешений для конфигурации помните, что у пользователей должно быть по крайней мере Execute(Invoke) разрешение на использование конфигурации сеанса в сеансе.

Нельзя использовать параметр SecurityDescriptorSDDL и этот параметр в той же команде.

Свойства параметра

Наборы параметров

-StartupScript

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

Чтобы удалить скрипт запуска из конфигурации сеанса, введите пустую строку ("") или значение $null.

Скрипт запуска можно использовать для дальнейшей настройки сеанса пользователя. Если скрипт создает ошибку, даже не завершающаяся ошибка, сеанс не создается и команда New-PSSession завершается ошибкой.

Свойства параметра

Наборы параметров

-ThreadApartmentState

Указывает состояние квартиры используемого модуля потоков. Допустимые значения:

• Unknown
• MTA
• STA

Свойства параметра

Наборы параметров

-ThreadOptions

Задает параметр параметров потока в конфигурации. Этот параметр определяет, как создаются потоки и используются при выполнении команды в сеансе. Допустимые значения для этого параметра:

• Default
• ReuseThread
• UseCurrentThread
• UseNewThread

Значение по умолчанию — UseCurrentThread.

Дополнительные сведения см. в перечисления PSThreadOptions.

Свойства параметра

Наборы параметров

-TransportOption

Задает параметры транспорта для конфигурации сеанса. Введите объект параметров транспорта, например объект WSManConfigurationOption, возвращаемый командлетом New-PSTransportOption.

Параметры сеансов, использующих конфигурацию сеанса, определяются значениями параметров сеанса и параметрами конфигурации сеанса. Если не указано, параметры, заданные в сеансе, например с командлетом New-PSSessionOption , имеют приоритет над параметрами, заданными в конфигурации сеанса. Однако значения параметров сеанса не могут превышать максимальные значения, заданные в конфигурации сеанса.

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-UseSharedProcess

Используйте только один процесс для размещения всех сеансов, запущенных одним пользователем, и использовать ту же конфигурацию сеанса. По умолчанию каждый сеанс размещается в собственном процессе.

Этот параметр появился в PowerShell 3.0.

Свойства параметра

Наборы параметров

-WhatIf

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

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

None

Выходные данные

WSManConfigLeafElement

Примечания

Связанные ссылки

• Disable-PSSessionConfiguration
• Enable-PSSessionConfiguration
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile
• New-PSSessionOption
• New-PSTransportOption
• Register-PSSessionConfiguration (регистрация конфигурации PS-сессии)
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• Поставщик WSMan
• о_Конфигурациях_Сессии
• about_Session_Configuration_Files (о_файлах_настроек_сессии)