Remove-PSSnapin

Windows PowerShell ek bileşenlerini geçerli oturumdan kaldırır.

Syntax

Default (Varsayılan)

Remove-PSSnapin
    [-Name] <String[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Remove-PSSnapin cmdlet'i geçerli oturumdan bir Windows PowerShell ek bileşenini kaldırır. Windows PowerShell'e eklediğiniz ek bileşenleri kaldırmak için kullanabilirsiniz Windows PowerShell ile yüklenen ek bileşenleri kaldırmak için bu cmdlet'i kullanamazsınız.

Bir ek bileşeni geçerli oturumdan kaldırdıktan sonra, ek bileşen yüklenmeye devam eder, ancak ek bileşendeki cmdlet'ler ve sağlayıcılar artık oturumda kullanılamaz.

Örnekler

Örnek 1: Ek bileşeni kaldırma

Remove-PSSnapin -Name Microsoft.Exchange

Bu komut, Microsoft.Exchange ek bileşenini geçerli oturumdan kaldırır. Komut tamamlandığında, ek bileşenin desteklediği cmdlet'ler ve sağlayıcılar oturumda kullanılamaz.

Örnek 2: İşlem hattıyla adları kullanarak ek bileşenleri kaldırma

Get-PSSnapin smp* | Remove-PSSnapin

Bu komut, geçerli oturumdan smp ile başlayan adlara sahip Windows PowerShell ek bileşenlerini kaldırır.

komutu, ek bileşenleri temsil eden nesneleri almak için Get-PSSnapin cmdlet'ini kullanır. İşlem hattı işleci (|), sonuçları Remove-PSSnapin cmdlet'ine gönderir ve bu da bunları oturumdan kaldırır. Bu ek bileşenin desteklediği sağlayıcılar ve cmdlet'ler artık oturumda kullanılamaz.

nesneleri Remove-PSSnapin'a aktardığınızda, nesnelerin adları, Name özelliğine sahip işlem hattından nesneleri kabul eden Name parametresiyle ilişkilendirilir.

Örnek 3: Adları kullanarak ek bileşenleri kaldırma

Remove-PSSnapin -Name *event*

Bu komut, olay içeren adları olan tüm Windows PowerShell ek bileşenlerini kaldırır.

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

-Name

Geçerli oturumdan kaldırılacak Windows PowerShell ek bileşenlerinin adlarını belirtir. Joker karakterlere (*) izin verilir.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
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

-PassThru

Ek bileşeni temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

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

PSSnapInInfo

Bir ek bileşen nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None, System.Management.Automation.PSSnapInInfo

Bu cmdlet, PassThru parametresini belirtirseniz, ek bileşeni temsil eden bir System.Management.Automation.PSSnapInInfo nesnesi oluşturur. Varsayılan olarak, Remove-PSSnapin herhangi bir çıkış oluşturmaz.

Notlar

Windows PowerShell, Remove-PSSnapiniçin aşağıdaki diğer adları içerir:

  • rsnp

Remove-PSSnapin, bir ek bileşeni oturumdan kaldırmadan önce Windows PowerShell sürümünü denetlemez. Ek bileşen kaldırılamazsa bir uyarı görüntülenir ve komut başarısız olur.

Remove-PSSnapin yalnızca geçerli oturumu etkiler. Windows PowerShell profilinize bir Add-PSSnapin komutu eklediyseniz, ek bileşeni gelecekteki oturumlardan kaldırmak için komutunu silmeniz gerekir. Yönergeler için Get-Help about_Profilesyazın.