Aracılığıyla paylaş

Unregister-PSSessionConfiguration

Modül:
Microsoft.PowerShell.Core Module

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

Sözdizimi

Default EnterprisePublishing 

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.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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.