Unregister-PSSessionConfiguration

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

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

Синтаксис

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

Описание

Этот командлет доступен только на платформе Windows.

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

Чтобы внести изменения в силу, Unregister-PSSessionConfiguration перезагрузит службу WinRM. Чтобы предотвратить перезапуск, укажите параметр NoServiceRestart .

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

Примеры

Пример 1. Удаление конфигурации сеанса

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

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Пример 2. Удаление конфигурации сеанса и перезапуск службы WinRM

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

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Пример 3. Удаление всех конфигураций сеанса

В этом примере показаны два способа удаления всех конфигураций сеанса на компьютере. Обе команды имеют одинаковый эффект и могут использоваться взаимозаменяемо.

Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration

Пример 4. Отмена регистрации без перезапуска

В этом примере показано, как использовать параметр NoServiceRestart , чтобы предотвратить перезагрузку службы, которая приведет к нарушению сеансов на компьютере.

PS> Unregister-PSSessionConfiguration -Name "MaintenanceShell" -NoServiceRestart
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

PS> New-PSSession -ConfigurationName "MaintenanceShell"

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

PS> Restart-Service winrm
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 resources, or logical endpoints.
 For more information, see the about_Remote_Troubleshooting Help topic.
 + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
 + FullyQualifiedErrorId : PSSessionOpenFailed

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

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

Командлет New-PSSession создает сеанс с помощью MaintenanceShell конфигурации. Команда выполняется успешно. Затем мы перезагрузим службу WinRM.

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

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Вы также можете передать конфигурации сеанса Unregister-PSSessionConfigurationв .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

Указывает, что этот командлет не перезапускает службу WinRM и подавляет запрос на перезапуск службы.

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

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

None

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

Примечания

Этот командлет доступен только на платформах Windows.

Чтобы запустить этот командлет, необходимо запустить PowerShell с помощью параметра "Запуск от имени администратора ".