Remove-PSSnapin
Odebere moduly snap-in Windows PowerShellu z aktuální relace.
Syntax
Default (Výchozí)
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 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ů
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 cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 (*).
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt, který představuje modul snap-in. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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 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.
