Unregister-PSSessionConfiguration

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

Syntax

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Unregister-PSSessionConfiguration Cmdlet, 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ği etkili Unregister-PSSessionConfiguration hale getirmek için WinRM hizmetini yeniden başlatır. Yeniden başlatmayı önlemek için NoServiceRestart parametresini belirtin.

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

Örnekler

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

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

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

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

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

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 oturum yapılandırmasını siler MaintenanceShell . 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-PSSessionConfiguration oturumu almaya MaintenanceShell çalışır. Oturum WS-Management kaynak tablosundan kaldırıldığından, Get-PSSessionConfiguration bunu döndüremez.

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

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

Parametreler

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 zorunludur.

Oturum yapılandırmalarını öğesine de yöneltebilirsiniz Unregister-PSSessionConfiguration.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 komut ç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, kullanıcılar kaydedilmemiş oturum yapılandırmasını bulmasa Get-PSSessionConfiguration bile kullanmaya devam edebilir.

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.