Запрещает доступ к конфигурациям сеанса на локальном компьютере.

Синтаксис

Disable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

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

Командлет Disable-PSSessionConfiguration добавляет параметр "deny all" в дескриптор безопасности одной или нескольких зарегистрированных конфигураций сеанса. В результате можно отменять регистрацию, просматривать и изменять конфигурации, однако использовать их в сеансе невозможно.

Без параметров Disable-PSSessionConfiguration отключает конфигурацию Microsoft.PowerShell, которая является конфигурацией по умолчанию, используемой для сеансов. Пока пользователь не укажет другую конфигурацию, локальным и удаленным пользователям запрещается создание каких-либо сеансов, выполняющих подключение к компьютеру.

Чтобы отключить все конфигурации сеансов, используйте Disable-PSRemoting.

Параметры

-Force

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

Обязательно?

false

Позиция?

named

Значение по умолчанию

False

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Name <string[]>

Задает имена отключаемых конфигураций сеанса. Введите одно или несколько имен конфигурации. Подстановочные знаки разрешены. Строку, содержащую имя конфигурации или объект конфигурации сеанса, можно передать командлету Disable-PSSessionConfiguration по конвейеру.

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

Обязательно?

false

Позиция?

1

Значение по умолчанию

Microsoft.PowerShell

Принимать входные данные из конвейера?

true (ByValue, ByPropertyName)

Принимать подстановочные знаки?

true

-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

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

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

None

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

Примечания

Чтобы использовать этот командлет в Windows Vista, Windows Server 2008 и более поздних версиях Windows, необходимо запускать Windows PowerShell командой "Запуск от имени администратора".

Пример 1

C:\PS>Disable-PSSessionConfiguration

Описание
-----------
Эта команда отключает конфигурацию сеанса Microsoft.PowerShell.






Пример 2

C:\PS>disable-pssessionConfiguration -name *

Описание
-----------
Эта команда удаляет с компьютера все зарегистрированные конфигурации сеансов.






Пример 3

C:\PS>disable-pssessionConfiguration -name Microsoft* -force

Описание
-----------
Эта команда отключает все конфигурации сеанса с именами, начинающимися с "Microsoft". Команда использует параметр Force для подавления всех запросов подтверждений от этой команды.






Пример 4

C:\PS>Get-PSSessionConfiguration -name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

Описание
-----------
Эта команда отключает конфигурации сеанса MaintenanceShell и AdminShell. 

Команда использует оператор конвейера (|) для отправки результатов команды Get-PSSessionConfiguration командлету Disable-PSSessionConfiguration.






Пример 5

C:\PS>Get-PSSessionConfiguration | format-table -property Name, Permission -auto

Name				 Permission
----				 ----------
MaintenanceShell	 BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

C:\PS> Disable-PSSessionConfiguration -name MaintenanceShell -force

C:\PS> Get-PSSessionConfiguration | format-table -property Name, Permission -auto

Name				 Permission
----				 ----------
MaintenanceShell	 Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

C:\PS> Set-PSSessionConfiguration -name MaintenanceShell -MaximumReceivedDataSizePerCommandMB 60

ParamName			ParamValue
---------			----------
psmaximumreceived... 60

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y


C:\PS> new-pssession -computername localhost -configurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message : Access is denied. For more information, see the about_Remote_Troubl
eshooting Help topic.
	+ CategoryInfo		: OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
	+ FullyQualifiedErrorId : PSSessionOpenFailed

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

Первая команда использует командлеты Get-SessionConfiguration и Format-Table для отображения только свойств Name и Permission объектов конфигурации сеанса. Этот табличный формат упрощает просмотр значений объектов. В результате показывается, что членам группы "Администраторы" разрешено использование конфигураций сеанса.

Вторая команда отключает конфигурацию сеанса MaintenanceShell с помощью командлета Disable-PSSessionConfiguration. Команда использует параметр Force для подавления всех запросов подтверждений.

Третья команда идентична первой. В результате показывается, что по-прежнему можно получить объект, представляющий конфигурацию сеанса MaintenanceShell, даже если всем заблокирован к нему доступ. Запись "AccessDenied" приоритетна по отношению ко всем другим записям в дескрипторе безопасности.

Четвертая команда использует командлет Set-PSSessionConfiguration для увеличения параметра MaximumDataSizePerCommandMB для конфигурации сеанса MaintenanceShell до 60. В результате команда завершается успешно, даже если всем заблокирован доступ к конфигурации.

Пятая команда пытается использовать конфигурацию сеанса MaintenanceShell в сеансе. Она использует командлет New-PSSession для создания нового сеанса и параметр ConfigurationName для указания конфигурации MaintenanceShell. В результате команда New-PSSession завершается ошибкой, поскольку пользователю запрещен доступ к конфигурации.






См. также