Поделиться через

Enable-PSSessionConfiguration

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Включает конфигурации сеанса на локальном компьютере.

Синтаксис

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Этот командлет доступен только на платформе Windows.

Командлет Enable-PSSessionConfiguration включает зарегистрированные конфигурации сеансов, которые были отключены, например с помощью командлетов Disable-PSSessionConfiguration или Disable-PSRemoting, или параметра AccessModeRegister-PSSessionConfiguration. Это расширенный командлет, предназначенный для использования системными администраторами для управления настраиваемыми конфигурациями сеансов для своих пользователей.

Без параметров Enable-PSSessionConfiguration включает конфигурацию Microsoft.PowerShell, которая является конфигурацией по умолчанию, используемой для сеансов.

Enable-PSSessionConfiguration удаляет параметр Deny_All из дескриптора безопасности конфигураций затронутых сеансов, включает прослушиватель, который принимает запросы по любому IP-адресу и перезапускает службу WinRM. Начиная с PowerShell 3.0, Enable-PSSessionConfiguration также задает значение свойства Enabled конфигурации сеанса (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) значение True. Однако Enable-PSSessionConfiguration не удаляет или не изменяет параметр дескриптора безопасности Network_Deny_All (AccessMode=Local), который позволяет использовать только пользователи локального компьютера в конфигурации сеанса.

Примеры

Пример 1. Повторное включение сеанса по умолчанию

Этот пример повторно включает конфигурацию сеанса Microsoft.PowerShell по умолчанию на компьютере.

Enable-PSSessionConfiguration

Пример 2. Повторное включение указанных сеансов

Этот пример повторно включает конфигурации сеансов MaintenanceShell и AdminShell на компьютере.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Пример 3. Повторное включение всех сеансов

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

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration не создает ошибку, если вы включите конфигурацию сеанса, которая уже включена.

Пример 4. Повторное включение сеанса и указание нового дескриптора безопасности

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

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

Параметры

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Указывает, что командлет не запрашивает подтверждение и перезапускает службу WinRM без запроса. Перезапуск службы делает изменение конфигурации эффективным.

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

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

Можно также передать строку, содержащую имя конфигурации или объект конфигурации сеанса, в Enable-PSSessionConfiguration.

Если этот параметр не указан, Enable-PSSessionConfiguration включает конфигурацию сеанса Microsoft.PowerShell.

Тип:String[]
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-NoServiceRestart

Указывает, что командлет не перезапускает службу.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SecurityDescriptorSddl

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

Если этот параметр не указан, Enable-PSSessionConfiguration удаляет только запретить весь элемент из дескриптора безопасности.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipNetworkProfileCheck

Указывает, что этот командлет включает конфигурацию сеанса при наличии компьютера в общедоступной сети. Этот параметр включает правило брандмауэра для общедоступных сетей, разрешающее удаленный доступ только с компьютеров в одной локальной подсети. По умолчанию Enable-PSSessionConfiguration завершается сбоем в общедоступной сети.

Этот параметр предназначен для клиентских версий операционной системы Windows. Версии операционной системы Windows имеют правило брандмауэра локальной подсети для общедоступных сетей. Однако если правило брандмауэра локальной подсети отключено в версии операционной системы Windows, этот параметр повторно включает его.

Чтобы удалить ограничение локальной подсети и включить удаленный доступ из всех расположений в общедоступных сетях, используйте командлет Set-NetFirewallRule в модуле NetSecurity. Дополнительные сведения см. в Enable-PSRemoting.

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Можно передать объект конфигурации сеанса или строку, содержащую имя конфигурации сеанса в этот командлет.

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

None

Этот командлет не возвращает объекты.

Примечания

Этот командлет доступен только на платформах Windows.

Чтобы использовать этот командлет, необходимо запустить PowerShell с помощью параметра запуска от имени администратора.