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

Enable-PSSessionConfiguration

Модуль:
Microsoft.PowerShell.Core Module

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

Синтаксис

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

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

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

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

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

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

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

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

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

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

(All)
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-NoServiceRestart

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SecurityDescriptorSddl

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

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

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SkipNetworkProfileCheck

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

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

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

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

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

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

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

String

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

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

None

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

Примечания

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

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