Sdílet prostřednictvím

Remove-PSSnapin

  • Reference
Modul:
Microsoft.PowerShell.Core

Odebere moduly snap-in Windows PowerShellu z aktuální relace.

Syntaxe

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

Description

Rutina Remove-PSSnapin odebere modul snap-in Windows PowerShellu z aktuální relace. Můžete ho použít k odebrání modulů snap-in, které jste přidali do prostředí Windows PowerShell. Tuto rutinu nelze použít k odebrání modulů snap-in nainstalovaných pomocí prostředí Windows PowerShell.

Po odebrání modulu snap-in z aktuální relace se modul snap-in stále načte, ale rutiny a zprostředkovatelé v modulu snap-in už nejsou v relaci k dispozici.

Příklady

Příklad 1: Odebrání modulu snap-in

PS C:\> remove-pssnapin -Name Microsoft.Exchange

Tento příkaz odebere modul snap-in Microsoft.Exchange z aktuální relace. Po dokončení příkazu nejsou v relaci k dispozici rutiny a poskytovatelé, které modul snap-in podporuje.

Příklad 2: Odebrání modulů snap-in pomocí názvů s kanálem

PS C:\> Get-PSSnapIn smp* | Remove-PSSnapIn

Tento příkaz odebere moduly snap-in prostředí Windows PowerShell, které mají názvy začínající smp z aktuální relace.

Příkaz používá rutinu Get-PSSnapin k získání objektů, které představují moduly snap-in. Operátor kanálu (|) odešle výsledky do rutiny Remove-PSSnapin, která je odebere z relace. Poskytovatelé a rutiny, které tento modul snap-in podporuje, už nejsou v relaci k dispozici.

Při kanálování objektů do Remove-PSSnapinjsou názvy objektů přidruženy k parametru Name, který přijímá objekty z kanálu, které mají vlastnost Name.

Příklad 3: Odebrání modulů snap-in pomocí názvů

PS C:\> Remove-PSSnapin -Name *event*

Tento příkaz odebere všechny moduly snap-in Windows PowerShellu, které obsahují názvy událostí.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje názvy modulů snap-in prostředí Windows PowerShell, které se mají odebrat z aktuální relace. Jsou povoleny zástupné znaky (*).

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Vrátí objekt, který představuje modul snap-in. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSSnapInInfo

K této rutině můžete připojit objekt snap-in.

Výstupy

None, System.Management.Automation.PSSnapInInfo

Tato rutina vygeneruje objekt System.Management.Automation.PSSnapInInfo, který představuje modul snap-in, pokud zadáte parametr PassThru. Ve výchozím nastavení Remove-PSSnapin nevygeneruje žádný výstup.

Poznámky

  • Remove-PSSnapin nekontroluje verzi Windows PowerShellu před odebráním modulu snap-in z relace. Pokud modul snap-in nejde odebrat, zobrazí se upozornění a příkaz selže.
  • Remove-PSSnapin ovlivňuje pouze aktuální relaci. Pokud jste do profilu Prostředí Windows PowerShell přidali příkaz Add-PSSnapin, měli byste příkaz odstranit, abyste modul snap-in odebrali z budoucích relací. Pokyny pište Get-Help about_Profiles.