Sdílet prostřednictvím

Remove-PSSnapin

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntax

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

Description

Rutina Remove-PSSnapin odebere modul snap-in Prostředí Windows PowerShell 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

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

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 pomocí rutiny Get-PSSnapin získá objekty, které představují moduly snap-in. Operátor kanálu (|) odešle výsledky do Remove-PSSnapin rutiny, která je odebere z relace. Poskytovatelé a rutiny, které tento modul snap-in podporuje, už nejsou v relaci k dispozici.

Při kanálu objekty 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ů

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 zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 (*).

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

-PassThru

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 negeneruje žádný výstup.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Remove-PSSnapin:

  • rsnp

Remove-PSSnapin před odebráním modulu snap-in z relace nekontroluje verzi Prostředí Windows PowerShell. 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 Add-PSSnapin příkaz, měli byste příkaz odstranit, abyste modul snap-in odebrali z budoucích relací. Pro pokyny zadejte Get-Help about_Profiles.