Aracılığıyla paylaş

Unregister-PSSessionConfiguration

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Kayıtlı oturum yapılandırmalarını bilgisayardan siler.

Sözdizimi

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Unregister-PSSessionConfiguration cmdlet'i, kayıtlı oturum yapılandırmalarını bilgisayardan siler. Bu cmdlet, sistem yöneticilerinin kullanıcılar için özelleştirilmiş oturum yapılandırmalarını yönetmesi için tasarlanmıştır.

Değişikliğin etkili olması için Unregister-PSSessionConfiguration WinRM hizmetini yeniden başlatır. Yeniden başlatmayı önlemek için NoServiceRestart parametresini belirtin.

Varsayılan Microsoft.PowerShell veya Microsoft.PowerShell32 oturum yapılandırmalarını yanlışlıkla silerseniz, bunları geri yüklemek için Enable-PSRemoting cmdlet'ini kullanın. Daha fazla bilgi için bkz. about_Session_Configurations.

Örnekler

Örnek 1: Oturum yapılandırmasını silme

Bu örnek, MaintenanceShell oturum yapılandırmasını bilgisayardan siler.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Örnek 2: Oturum yapılandırmasını silme ve WinRM hizmetini yeniden başlatma

Bu örnekte, MaintenanceShell yapılandırmasını silip WinRM hizmetini yeniden başlatacağız. Force parametresi, winrm hizmetini istemeden yeniden başlatmak için tüm kullanıcı iletilerini engeller.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Örnek 3: Tüm oturum yapılandırmalarını silme

Bu örneklerde bilgisayardaki tüm oturum yapılandırmalarını silmenin iki yolu gösterilmektedir. Her iki komut da aynı etkiye sahiptir ve birbirinin yerine kullanılabilir.

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

Örnek 4: Yeniden başlatma olmadan kaydı kaldırma

Bu örnek, bilgisayardaki tüm oturumları kesintiye uğratacak bir hizmetin yeniden başlatılmasını önlemek için NoServiceRestart parametresini kullanmanın etkisini gösterir.

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 oturum yapılandırmasını siler. Ancak, komut NoServiceRestart parametresini kullandığından WinRM hizmeti yeniden başlatılmaz ve değişiklik henüz tamamen etkili değildir.

Ardından, Get-PSSessionConfigurationMaintenanceShell oturumunu almaya çalışır. Oturum WS-Management kaynak tablosundan kaldırıldığından Get-PSSessionConfiguration bunu döndüremez.

New-PSSession cmdlet'i MaintenanceShell yapılandırmasını kullanarak bir oturum oluşturur. Komut başarılı olur. Ardından WinRM hizmetini yeniden başlatacağız.

Son olarak, New-PSSession cmdlet'i MaintenanceShell yapılandırmasını kullanan bir oturum oluşturmaya çalışır. Bu kez, WinRM hizmeti yeniden başlatıldığında MaintenanceShell yapılandırması silindiğinden oturum başarısız olur.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Cmdlet'in sizden onay istemediğini ve sormadan WinRM hizmetini yeniden başlatdığını gösterir. Hizmetin yeniden başlatılması yapılandırma değişikliğini etkili hale getirir.

Yeniden başlatmayı önlemek ve yeniden başlatma istemini engellemek için NoServiceRestart parametresini kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Silinecek oturum yapılandırmalarının adlarını belirtir. Bir oturum yapılandırma adı veya yapılandırma adı deseni girin. Joker karakterlere izin verilir. Bu parametre gereklidir.

Ayrıca oturum yapılandırmalarını Unregister-PSSessionConfiguration' e de yöneltebilirsiniz.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

-NoServiceRestart

Bu cmdlet'in WinRM hizmetini yeniden başlatmadığını gösterir ve hizmeti yeniden başlatma istemini gizler.

Varsayılan olarak, bir Unregister-PSSessionConfiguration komutu çalıştırdığınızda, değişikliğin etkili olması için WinRM hizmetini yeniden başlatmanız istenir. WinRM hizmeti yeniden başlatılana kadar, Get-PSSessionConfiguration tarafından bulunamasa da kullanıcılar kaydedilmemiş oturum yapılandırmasını kullanmaya devam edebilir.

İstenmeden WinRM hizmetini yeniden başlatmak için Zorla parametresini belirtin. WinRM hizmetini el ile yeniden başlatmak için Restart-Service cmdlet'ini kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Oturum yapılandırma nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.

Bu cmdlet'i çalıştırmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatmanız gerekir.