Разрешает доступ к конфигурациям сеанса на локальном компьютере.
Синтаксис
Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Enable-PSSessionConfiguration повторно включает зарегистрированные конфигурации сеансов, которые были отключены с помощью командлета Disable-PSSessionConfiguration. Этот расширенный командлет предназначен для использования системными администраторами и позволяет управлять конфигурациями сеансов для пользователей.
Без параметров Enable-PSSessionConfiguration повторно включает конфигурацию Microsoft.PowerShell, которая является конфигурацией по умолчанию, используемой для сеансов.
Этот командлет выполняет следующие операции для каждой включенной конфигурации.
-- Удаляет параметр "deny all" из дескриптора безопасности конфигурации или заменяет дескриптор безопасности одним из указанных.
-- Включает прослушиватель, принимающий запросы по любому IP-адресу.
-- Перезапускает службу WinRM.
Командлет Enable-PSSessionConfiguration вызывает командлет Set-WSManQuickConfig. Однако его не следует использовать для обеспечения удаленного доступа к компьютеру. Вместо него следует использовать более сложный командлет Enable-PSRemoting.
Параметры
-Force
Подавляет все запросы пользователю и перезапускает службу WinRM без запроса подтверждения. Перезапуск службы обеспечивает вступление изменений конфигурации в силу.
Чтобы предотвратить перезапуск и подавить запрос на перезапуск, используйте параметр NoServiceRestart.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Name <string[]>
Задает имена включаемых конфигураций сеанса. Введите одно или несколько имен конфигурации. Подстановочные знаки разрешены.
Строку, содержащую имя конфигурации или объект конфигурации сеанса, можно передать командлету Enable-PSSessionConfiguration по конвейеру.
Если этот параметр не указан, Enable-PSSessionConfiguration включает конфигурацию сеанса Microsoft.PowerShell.
|
Обязательно? |
false |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue, ByPropertyName) |
|
Принимать подстановочные знаки? |
true |
-SecurityDescriptorSDDL <string>
Заменяет дескриптор безопасности для конфигурации сеанса указанным дескриптором безопасности.
Если этот параметр не указан, Enable-PSSessionConfiguration всего лишь удаляет элемент "deny all" из дескриптора безопасности.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String Объект конфигурации сеанса или строку, содержащую имя конфигурации сеанса, можно передать командлету Enable-PSSessionConfiguration по конвейеру. |
|
Выходные данные |
None Этот командлет не возвращает никаких объектов. |
Примечания
Чтобы использовать этот командлет в Windows Vista, Windows Server 2008 и более поздних версиях Windows, необходимо запускать Windows PowerShell командой "Запуск от имени администратора".
Пример 1
C:\PS>Enable-PSSessionConfiguration Описание ----------- Эта команда повторно запускает конфигурацию сеансов Microsoft.PowerShell по умолчанию на компьютере.
Пример 2
C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell Описание ----------- Эта команда повторно включает конфигурации сеанса MaintenanceShell и AdminShell на компьютере.
Пример 3
C:\PS>Enable-PSSessionConfiguration -name * C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration Описание ----------- Эти команды повторно включают все конфигурации сеансов на компьютере. Команды эквивалентны, поэтому можно использовать любую из них. Enable-PSSessionConfiguration не возвращает ошибки при включении уже включенной конфигурации сеанса.
Пример 4
C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P" Описание ----------- Эта команда повторно включает конфигурацию сеанса MaintenanceShell и задает для конфигурации новый дескриптор безопасности.