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

Enable-PSSessionConfiguration

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

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

Синтаксис

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

Описание

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

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

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

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

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

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 из дескриптора безопасности удаляется только элемент deny all.

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

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

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

None

Этот командлет не создает никаких объектов.

Примечания

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

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