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.
İlişkili Bağlantılar
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan Sağlayıcısı
- about_Session_Configurations
- about_Session_Configuration_Files
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin