Enable-PSSessionConfiguration
Включает конфигурации сеанса на локальном компьютере.
Синтаксис
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Enable-PSSessionConfiguration
включает зарегистрированные конфигурации сеансов, которые были отключены, например с помощью Disable-PSSessionConfiguration
командлетов Disable-PSRemoting
или параметра Register-PSSessionConfiguration
AccessMode. Этот расширенный командлет предназначен для использования системными администраторами и позволяет управлять конфигурациями сеансов для пользователей.
Без параметров 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. Повторное включение сеанса и указание нового дескриптора безопасности
Этот пример повторно включает конфигурацию сеанса обслуживания и задает новый дескриптор безопасности для конфигурации.
$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
Этот командлет не возвращает выходные данные.
Примечания
Чтобы использовать этот командлет, необходимо запустить PowerShell с помощью параметра запуска от имени администратора .
Связанные ссылки
- Disable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- Поставщик WSMan
- about_Session_Configurations
- about_Session_Configuration_Files
PowerShell