Remove-PSSnapin

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

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

Syntax

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

Description

Cmdlet, Remove-PSSnapin 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 cmdlet'ini kullanır Get-PSSnapin . İşlem hattı işleci (|), sonuçları cmdlet'ine Remove-PSSnapin 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 öğesine Remove-PSSnapinaktardığınızda, nesnelerin adları name parametresiyle ilişkilendirilir ve bu parametre, işlem hattından Name özelliğine sahip nesneleri kabul eder.

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

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

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

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

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 için aşağıdaki diğer adları Remove-PSSnapiniçerir:

  • rsnp

Remove-PSSnapin oturumdan ek bileşeni 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 komut eklediyseniz, ek bileşeni gelecekteki oturumlardan kaldırmak için komutunu silmeniz gerekir. Yönergeler için yazın Get-Help about_Profiles.