Enable-PSSessionConfiguration

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

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

Синтаксис

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

Описание

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

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

Без параметров 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. Повторное включение указанных сеансов

Этот пример повторно включает конфигурации сеансов обслуживания и Администратор Shell на компьютере.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

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

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

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

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

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

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

$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

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

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

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

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

String

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

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

None

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

Примечания

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

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