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

Синтаксис

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

Описание

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

Если по ошибке были удалены конфигурации сеанса по умолчанию Microsoft.PowerShell или Microsoft.PowerShell32, для их восстановления воспользуйтесь командлетом Enable-PSRemoting.

Параметры

-Force

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

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Name <string>

Задает имена удаляемых конфигураций сеансов. Введите одно или несколько имен конфигурации. Подстановочные знаки разрешены. Это обязательный параметр.

Кроме того, можно передать объект конфигурации сеанса командлету Unregister-PSSessionConfiguration по конвейеру.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByPropertyName)
Принимать подстановочные знаки?	false

-NoServiceRestart

Не перезапускает службу WinRM и подавляет запрос на перезапуск службы.

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

Чтобы перезапустить службу WinRM без запроса подтверждения, используйте параметр Force. Чтобы перезапустить службу WinRM вручную, используйте командлет Restart-Service.

Обязательно?	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

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

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

Нет

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

Примечания

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

Пример 1

C:\PS>unregister-pssessionconfiguration -name MaintenanceShell

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

Пример 2

C:\PS>unregister-pssessionconfiguration -maintenanceShell -force

Описание
-----------
Эта команда удаляет с компьютера конфигурацию сеанса MaintenanceShell. В команде используется параметр Force, чтобы подавить все сообщения пользователю и перезапустить службу WinRM без запроса подтверждения.

Пример 3

C:\PS>unregister-pssessionconfiguration -name *

C:\PS> get-pssessionconfiguration -name * | unregister-pssessionconfiguration

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

Пример 4

C:\PS>unregister-pssessionconfiguration -name maintenanceShell -noServiceRestart

C:\PS> get-pssessionconfiguration -name maintenanceShell

Get-PSSessionConfiguration -name maintenanceShell : No Session Configuration matches criteria "maintenanceShell".
	+ CategoryInfo		: NotSpecified: (:) [Write-Error], WriteErrorException
	+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

C:\PS> new-pssession -configurationName MaintenanceShell

 Id Name	ComputerName	State	Configuration		 Availability
 -- ----	------------	-----	-------------		 ------------
  1 Session1  localhost	 Opened   MaintenanceShell	Available

C:\PS> restart-service winrm

C:\PS> new-pssession -configurationName MaintenanceShell
[localhost] Connecting to remote server failed with the following error message : The WS-Management service cannot process the request. The resource
URI (http://schemas.microsoft.com/powershell/MaintenanceShell) was not found in the WS-Management catalog. The catalog contains the metadata that describes resour
ces, or logical endpoints. For more information, see the about_Remote_Troubleshooting Help topic.
	+ CategoryInfo		: OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
	+ FullyQualifiedErrorId : PSSessionOpenFailed

Описание
-----------
В этом примере показан результат использования параметра NoServiceRestart командлета Unregister-PSSessionConfiguration. Этот параметр предназначен для предотвращения перезапуска службы, который мог бы нарушить работу каких-либо служб на компьютере.

Первая команда удаляет конфигурацию сеанса MaintenanceShell с помощью командлета Unregister-PSSessionConfiguration. Однако так как в команде используется параметр NoServiceRestart, служба WinRM не перезапускается и изменения не полностью вводятся в действие.

Вторая команда получает сеанс MaintenanceShell с помощью командлета Get-PSSessionConfiguration. Так как сеанс был удален из таблицы ресурсов WS-Management, командлет Get-PSSession не может вернуть его.

Третья команда использует командлет New-PSSession для создания на локальном компьютере сеанса, который использует конфигурацию MaintenanceShell. Команда выполняется успешно.

Четвертая команда с помощью командлета Restart-Service перезапускает службу WinRM. 

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

Unregister-PSSessionConfiguration