Удаляет зарегистрированные конфигурации сеанса с компьютера.
Синтаксис
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 (https://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 была удалена.
См. также